GPT-Image-2

模型名称：gpt-image-2

面向通用图像生成与参考图生成场景
异步任务协议提交成功后返回 task_id
支持文生图与图生图
size 支持 auto 与 15 种固定画面比例，包括全景生成需要的 2:1
resolution 支持 1k、2k、4k
参考图最多 16 张，单图也使用数组传入

请求鉴权

所有接口均需要使用 Bearer Token 进行认证。获取 API Key：从平台上获取。使用时在请求头中添加：

Authorization: Bearer YOUR_API_KEY

提交任务接口

POST /v1/images/generations

提交图片异步任务。接口受理成功后会立即返回 task_id，实际图片结果需要通过任务查询接口继续轮询。

请求参数

字段	类型	默认值	说明
`model`（必填）	`string`	-	固定传 `gpt-image-2`
`prompt`（必填）	`string`	-	图片生成提示词
`n`	`number`	`1`	当前仅支持传 `1`
`size`	`string`	`auto`	图片比例
`resolution`	`string`	`1k`	清晰度档位
`images`	`string[]`	-	参考图地址数组

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。
resolution 支持：1k、2k、4k。
images 最多支持 16 张，单图也使用数组传入。
最终图片地址不由请求字段切换：请在异步查询响应的 works[].asset_url 中读取。

响应

成功响应示例：

{
  "code": 200,
  "data": {
    "task_id": "task_01KQEXAMPLE123456789",
    "status": "submitted",
    "model": "gpt-image-2"
  }
}

失败响应示例：

{
  "error": {
    "code": 400,
    "type": "invalid_request_error",
    "message": "参数错误，请检查 prompt、size、resolution 或 images 是否符合当前模型要求"
  }
}

任务查询接口

GET /v1/tasks/{task_id}

使用提交阶段返回的 task_id 查询当前任务状态。任务成功后，可从结果对象里读取图片地址。说明：

works[].asset_url 为平台最终返回的稳定资源地址。
works 始终是数组；当前 gpt-image-2 限制 n=1，但调用方应按数组遍历结果。
images 是请求中的参考图数组，works 是任务输出作品数组，两者语义不同。
调用方不需要感知底层原始资源地址。

响应

成功结果示例：

{
  "code": 200,
  "data": {
    "task_id": "task_01KQEXAMPLE123456789",
    "status": "succeeded",
    "works": [
      {
        "asset_url": "https://example.com/result/image-01.png"
      }
    ]
  }
}

协议支持一次任务返回多个作品，结构示例如下；是否实际返回多张由具体模型的 n 能力决定：

{
  "code": 200,
  "data": {
    "task_id": "task_01KQEXAMPLE123456789",
    "status": "succeeded",
    "works": [
      {"asset_url": "https://example.com/result/image-01.png"},
      {"asset_url": "https://example.com/result/image-02.png"}
    ]
  }
}

处理中示例：

{
  "code": 200,
  "data": {
    "task_id": "task_01KQEXAMPLE123456789",
    "status": "processing",
    "works": []
  }
}

任务失败示例：

{
  "code": 200,
  "data": {
    "task_id": "task_01KQEXAMPLE123456789",
    "status": "failed",
    "works": [],
    "fail_reason": "任务生成失败，请稍后重试"
  }
}

成功查询到一个失败任务仍返回 HTTP 200；鉴权失败、参数错误、任务不存在或服务异常使用相应 HTTP 状态码。

使用示例

文生图

curl --request POST \
  --url https://api.aimaxa.cn/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "生成一张高转化电商主图，主体是一瓶橙花香水，白底干净构图，玻璃高光自然，商业摄影风格",
    "n": 1,
    "size": "1:1",
    "resolution": "2k"
  }'

图生图

curl --request POST \
  --url https://api.aimaxa.cn/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "保留人物主体姿态与服装，改为清晨自然光人像摄影，肤色真实，背景为白色纱帘",
    "n": 1,
    "size": "3:4",
    "resolution": "1k",
    "images": [
      "https://example.com/reference-1.jpg"
    ]
  }'

多参考图图生图

curl --request POST \
  --url https://api.aimaxa.cn/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "把两张参考图融合为一张电影海报，保留人物主体与车辆造型，统一成深夜霓虹街头氛围",
    "n": 1,
    "size": "16:9",
    "resolution": "2k",
    "images": [
      "https://example.com/reference-1.jpg",
      "https://example.com/reference-2.jpg"
    ]
  }'

注意事项

size=auto 可直接传入，由模型按当前能力处理。
提交成功后请使用返回的 task_id 轮询任务结果。
n 当前仅支持传 1，参考图统一通过 images 数组传入。
任务完成后，结果中的作品地址为平台稳定资源地址，不会要求业务侧直接处理底层原始资源链接。

开始使用

图像模型

视频模型

文本模型

请求鉴权

提交任务接口

请求参数

响应

任务查询接口

响应

使用示例

文生图

图生图

多参考图图生图

注意事项

​请求鉴权

​提交任务接口

​请求参数

​响应

​任务查询接口

​响应

​使用示例

​文生图

​图生图

​多参考图图生图

​注意事项

请求鉴权

提交任务接口

请求参数

响应

任务查询接口

响应

使用示例

文生图

图生图

多参考图图生图

注意事项