作图 API 文档

统一异步作图

请求体里的 workflow 决定任务类型。提交立即返回任务 ID，客户端使用同一把 API Key 轮询结果。

公共字段

文生图：generate

curl https://img.94576354.xyz/v1/image-tasks \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Idempotency-Key: order-20260721-001" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow": "generate",
    "prompt": "生成 3 张不同构图的白底产品主图",
    "model": "gpt-image-2",
    "size": "2048x2048",
    "quality": "high",
    "count": 3,
    "batch_concurrency": 3
  }'

图片编辑：edit

下面示例同时使用正面、侧面和细节 3 张参考图。服务端会把全部参考图一起交给图片模型。

curl https://img.94576354.xyz/v1/image-tasks \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Idempotency-Key: edit-20260721-001" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow": "edit",
    "prompt": "综合全部参考图，保持产品结构、颜色和细节一致，改成白色摄影棚背景",
    "image_asset_ids": [
      "imgasset_11111111111111111111111111111111",
      "imgasset_22222222222222222222222222222222",
      "imgasset_33333333333333333333333333333333"
    ],
    "size": "2048x2048",
    "quality": "high",
    "count": 2
  }'

AI 理解后作图：intent

多图输入适合产品多角度、人物套图和空间方案。AI 会先综合理解全部参考图，再拆解输出方案。

curl https://img.94576354.xyz/v1/image-tasks \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Idempotency-Key: intent-20260721-001" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow": "intent",
    "prompt": "理解参考图，生成同一产品的 6 个商业展示角度",
    "images": [
      { "image_asset_id": "imgasset_11111111111111111111111111111111" },
      { "image_asset_id": "imgasset_22222222222222222222222222222222" },
      { "image_asset_id": "imgasset_33333333333333333333333333333333" }
    ],
    "size": "2048x2048",
    "quality": "high",
    "count": 6
  }'

Responses 生图：responses

Responses 使用多个 input_image 内容项传入多张参考图。

curl https://img.94576354.xyz/v1/image-tasks \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Idempotency-Key: responses-20260721-001" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow": "responses",
    "model": "gpt-5.5",
    "input": [{
      "role": "user",
      "content": [
        { "type": "input_text", "text": "综合三张参考图并生成一张 2K 商业海报" },
        { "type": "input_image", "image_asset_id": "imgasset_11111111111111111111111111111111" },
        { "type": "input_image", "image_asset_id": "imgasset_22222222222222222222222222222222" },
        { "type": "input_image", "image_asset_id": "imgasset_33333333333333333333333333333333" }
      ]
    }],
    "tools": [{
      "type": "image_generation",
      "size": "2048x2048",
      "quality": "high",
      "output_format": "png"
    }]
  }'

提交返回

{
  "task_id": "7f7c3c...",
  "workflow": "generate",
  "status": "queued",
  "count": 3,
  "poll_url": "/v1/image-tasks/7f7c3c..."
}

轮询任务

curl https://img.94576354.xyz/v1/image-tasks/7f7c3c... \
  -H "Authorization: Bearer sk-xxxx"

建议每 2-3 秒查询一次。只要某张图先完成，ready_images 就会先返回该图片，不需要等待整批结束。

图片资产

需要反复使用同一张参考图时，先上传一次并保存返回的 image_asset_id。

上传本地图片

curl https://img.94576354.xyz/v1/images/assets \
  -H "Authorization: Bearer sk-xxxx" \
  -F "file=@reference.png"

导入公网 HTTPS 图片

curl https://img.94576354.xyz/v1/images/assets/import \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://images.example.com/reference.png",
    "filename": "reference.png"
  }'

资产返回

{
  "image_asset_id": "imgasset_0123456789abcdef0123456789abcdef",
  "object": "image.asset",
  "filename": "reference.png",
  "content_type": "image/png",
  "bytes": 123456,
  "expires_at": 1784422800
}

edit 和 intent 支持 image_asset_id、image_asset_ids、image_asset_id[]、images[].image_asset_id，也支持 files[].b64。

多图字段怎么选

OpenAI 标准同步接口

只需要单张图片、并且客户端可以保持长连接时，可以继续使用 OpenAI 标准接口。

同步文生图

curl https://img.94576354.xyz/v1/images/generations \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "白底产品主图，柔光，商业摄影",
    "size": "1024x1024",
    "quality": "medium",
    "n": 1
  }'

同步图片编辑

curl https://img.94576354.xyz/v1/images/edits \
  -H "Authorization: Bearer sk-xxxx" \
  -F "model=gpt-image-2" \
  -F "prompt=保持主体，改成白色摄影棚背景" \
  -F "size=1024x1024" \
  -F "quality=medium" \
  -F "image=@input.png"

限制与错误

• generate、edit、intent 单任务最多 15 张。
• 输入图片最多 16 张，单张最大 20 MiB。
• JSON 请求体最大 32 MiB；大图优先使用图片资产。
• prompt 最长 3000 字符。
• 输出格式支持 PNG、JPEG、WebP。
• 图片资产默认有效期 24 小时。