用途:该技能用于向 APIMart 提交 GPT-Image-2 图片任务,轮询异步结果并下载返回的图片 URL,适合在 Codex 中需要 APIMart 图片生成的场景。
主要能力:支持文生图、基于公网 URL 的图生图、基于本地文件的图生图,以及查询已有任务状态并下载结果。模型固定为 gpt-image-2,n 固定为整数 1。
使用方式:API 密钥从环境变量读取,优先使用 export APIMART_API_KEY="...",也接受 APIMART_TOKEN 作为回退,禁止硬编码密钥。常规请求使用附带脚本,例如:python scripts/apimart_image_gen.py generate --prompt "一只橘猫坐在窗台上看夕阳,水彩画风格" --size "16:9" --resolution "2k" --output-dir ./outputs/apimart-image-gen。脚本会提交 POST /v1/images/generations,等待后查询 GET /v1/tasks/{task_id},并将完成的图片 URL 下载到 --output-dir。查询任务可用 status 子命令配合 --task-id 与 --download;可用 --dry-run 在不调用 API 的情况下校验请求结构。
限制:有效 resolution 为 1k、2k、4k;有效比例包括 auto、1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、3:1、1:3、21:9、9:21,也接受如 1881x836 的像素尺寸。参考图最多 16 张,可跨 --image-url 与 --image-file 提供。建议将宽高比放在 --size 而非提示词中。结果 URL 带有 expires_at,应尽快下载。端点细节、状态值、错误处理与尺寸映射见 references/api.md。