GPT-Image-2.5 图片生成

模型名称：gpt-image-2.5

面向通用图像生成、参考图创作与高精度编辑场景
通过 version 选择创作模式：flare（默认，快速创作）或 sunburst（高精度编辑）
异步任务协议提交成功后返回 task_id
size 支持 auto 与 10 种固定画面比例
resolution 支持 1k、2k、4k
参考图最多 16 张，单图也使用数组传入

请求鉴权

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

Authorization: Bearer YOUR_API_KEY

创作模式

gpt-image-2.5 对外是单模型，通过 version 参数区分创作模式，不需要切换模型名称。

显示名称	`model`	`version`
Flare（默认）	`gpt-image-2.5`	`flare`
Sunburst	`gpt-image-2.5`	`sunburst`

flare：快速创作，适合日常出图与批量生成
sunburst：高精度编辑，适合主体保持、局部改写与专业修图

未传 version 时按 flare 处理；传入 flare、sunburst 以外的值会返回参数错误。

提交任务接口

POST /v1/images/generations

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

请求参数

字段	类型	默认值	说明
`model`（必填）	`string`	-	固定传 `gpt-image-2.5`
`prompt`（必填）	`string`	-	图片生成或编辑的提示词，去除首尾空格后不能为空
`version`	`string`	`flare`	创作模式，`flare` 或 `sunburst`
`size`	`string`	`auto`	图片比例
`resolution`	`string`	`1k`	清晰度档位
`images`	`string[]`	-	参考图地址数组

size 支持：auto、1:1、16:9、9:16、4:3、3:4、3:2、2:3、5:4、4:5、21:9。
resolution 支持：1k、2k、4k。
images 最多支持 16 张，单图也使用数组传入；不传参考图时为文生图，传入后为图生图，参考图不增加费用。
平台创作页不展示数量字段，调用方省略 n 时由 NewAPI 按 1 处理。
最终图片地址不由请求字段切换：请在异步查询响应的 works[].asset_url 中读取。

响应

成功响应示例：

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

失败响应示例：

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

任务查询接口

GET /v1/tasks/{task_id}

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

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

响应

成功结果示例：

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

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

{
  "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 状态码。

使用示例

文生图（Flare）

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.5",
    "version": "flare",
    "prompt": "未来感城市中的空中花园，清晨薄雾，建筑摄影",
    "size": "16:9",
    "resolution": "2k"
  }'

图生图（Sunburst）

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.5",
    "version": "sunburst",
    "prompt": "保留商品主体和包装文字，将背景替换为柔和的米白色摄影棚，并增加自然投影",
    "size": "1:1",
    "resolution": "2k",
    "images": [
      "https://example.com/product.png"
    ]
  }'

多参考图图生图

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.5",
    "version": "sunburst",
    "prompt": "以第一张图的商品为主体，参考第二张图的布景，生成横版广告图",
    "size": "16:9",
    "resolution": "2k",
    "images": [
      "https://example.com/product.png",
      "https://example.com/set.jpg"
    ]
  }'

自动比例与 4K 分辨率

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.5",
    "version": "flare",
    "prompt": "极简风格的产品发布会主视觉，由画面内容决定合适的构图比例",
    "size": "auto",
    "resolution": "4k"
  }'

注意事项

size=auto 可直接传入，由模型按当前能力处理。
提交成功后请使用返回的 task_id 轮询任务结果。
平台创作页默认不提交 n，NewAPI 在请求适配层补齐 n=1，因此省略 n 与显式传入 n:1 的计费和上游行为一致。
version 仅支持 flare 与 sunburst，参考图统一通过 images 数组传入。
任务完成后，结果中的作品地址为平台稳定资源地址，不会要求业务侧直接处理底层原始资源链接。

开始使用

图像模型

视频模型

文本模型

GPT-Image-2.5 图片生成

请求鉴权

创作模式

提交任务接口

请求参数

响应

任务查询接口

响应

使用示例

文生图（Flare）

图生图（Sunburst）

多参考图图生图

自动比例与 4K 分辨率

注意事项

​请求鉴权

​创作模式

​提交任务接口

​请求参数

​响应

​任务查询接口

​响应

​使用示例

​文生图（Flare）

​图生图（Sunburst）

​多参考图图生图

​自动比例与 4K 分辨率

​注意事项

请求鉴权

创作模式

提交任务接口

请求参数

响应

任务查询接口

响应

使用示例

文生图（Flare）

图生图（Sunburst）

多参考图图生图

自动比例与 4K 分辨率

注意事项