GPT-Image-2 图像生成

• 模型名：gpt-image-2（固定）
• 接口：POST https://apimaster.ai/v1/images/generations
• 模式：异步；返回 task_id，需轮询 任务查询
• 能力：文生图、图生图（参考图最多 16 张，URL 与 base64 可混填）

认证

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

请求参数

字段	类型	必填	说明
model	string	是	固定 gpt-image-2
prompt	string	是	画面描述（中英文）；会经平台安全审核
n	integer	否	生成张数，当前为 1（传数字，不要加引号）
size	string	否	比例，默认 1:1；见下表
resolution	string	否	1k / 2k / 4k，默认 1k
image_urls	array	否	参考图；传入后为图生图
official_fallback	boolean	否	是否官方渠道兜底，默认 false

size 支持的比例

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。

resolution 与像素（节选）

size	1k	2k	4k
1:1	1024×1024	2048×2048	2880×2880
16:9	1536×864	2048×1152	3840×2160
9:16	864×1536	1152×2048	2160×3840

4K 支持上表全部 15 种比例。

image_urls（图生图）

• 最多 16 张，超出会报错
• 支持公网 URL 与 base64 data URI（data:image/png;base64,...）混填
• 不传 size 时输出分辨率可跟随输入图；传 size 则按指定比例出图

请求示例

文生图（最简）

{
  "model": "gpt-image-2",
  "prompt": "一只橘猫坐在窗台上看夕阳，水彩画风格"
}

文生图（16:9 + 2K）

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a corgi astronaut on the moon, cinematic, 8k",
    "size": "16:9",
    "resolution": "2k"
  }'

图生图（URL + base64 混填）

{
  "model": "gpt-image-2",
  "prompt": "把这两张照片融合成一张海报",
  "size": "4:3",
  "resolution": "2k",
  "image_urls": [
    "https://example.com/photo-a.jpg",
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  ]
}

提交响应

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KPQ7J7DWB7QZ3WCEK3YVPBRA"
    }
  ]
}

HTTP	含义
200	已提交
400	参数错误（size / resolution 不合法等）
401	API Key 无效
402	余额不足
429	限流
500 / 503	服务或上游异常

查询任务结果

curl -s "https://apimaster.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

完成示例（结构示意）

{
  "code": 200,
  "data": {
    "id": "task_01KPQ7J7DWB7QZ3WCEK3YVPBRA",
    "status": "completed",
    "progress": 100,
    "result": {
      "images": [
        {
          "url": ["https://example.com/output.png"],
          "expires_at": 1776835126
        }
      ]
    }
  }
}

取图：data.result.images[0].url[0]

任务状态

status	说明
submitted	已提交
processing	处理中
completed	成功，可读 result.images
failed	失败，查看 error.message

轮询建议

• 提交后 10–20 秒 再首次查询
• 间隔 3–5 秒，避免毫秒级狂刷
• 单张图常见 30–60 秒 完成
• 多任务可用 POST https://apimaster.ai/v1/tasks/batch，body：{"task_ids":["task_a","task_b"]}

注意事项

1. 异步：必须先拿 task_id 再轮询，不会同步返回最终图片。
2. 审核：prompt 违规会直接拒绝，通常不计费。
3. 比例：推荐只用 size 字段指定比例，避免在 prompt 里重复写比例造成冲突。
4. 计费：按分辨率档位（1K / 2K / 4K）；失败与审核未通过 generally 不扣费（以控制台为准）。
5. 链接时效：返回 URL 建议在 expires_at 前下载或转存自有存储。

与官方渠道对比见 GPT-Image-2 官方渠道。