开发者参考

GPT Image 2.6 API 文档

创建 API 密钥，提交生成请求，再查询任务以获取图像。

创建 API 密钥

登录后，在账户中创建密钥。运行以下示例前，请在服务端环境中将 GPT_IMAGE_API_KEY 设置为该密钥。

管理 API 密钥

请将密钥保存在服务端。两个接口均通过 Authorization: Bearer 使用用户 API 密钥鉴权，无需浏览器 Cookie。

生成请求使用账户中的积分。相同设置下，Flare 和 Sunburst 的积分费用相同。查看当前图像费用

提交生成请求

POST /api/generate

将下方 JSON 保存为 request.json。此示例根据文字生成图像；如需通过参考图进行编辑，请添加下文说明的 images 数组。

请求体： `request.json`

{
  "model": "gpt-image-2.6",
  "variant": "flare",
  "prompt": "一只蓝色陶瓷杯放在木桌上，背景是暖色纸张。",
  "quality": "medium",
  "resolution": "1k",
  "complexity": "high",
  "output_format": "png"
}

从服务端发送

curl --request POST https://gptimage-26.com/api/generate \
  --header "Authorization: Bearer $GPT_IMAGE_API_KEY" \
  --header "Content-Type: application/json" \
  --data @request.json

提交成功后返回 code 200、data.task_id、值为 IN_PROGRESS 的 data.status，以及 data.consumed_credits。请保存 data.task_id，用于查询任务状态。

请求字段

字段	含义与可用值
`model`	使用 gpt-image-2.6；省略时也默认使用此模型。
`variant`	可选值：flare, sunburst。默认 flare；设为 sunburst 即使用 Sunburst。
`prompt`	必填文本，去除两端空白后长度为 1 至 20000 个字符。
`quality`	可选值：low, medium, high, xhigh, max。默认 medium。
`resolution`	可选值：1k, 2k, 4k。默认 1k。
`complexity`	构图规划，可选值：low, medium, high。默认 high。
`output_format`	可选值：png, jpeg, webp。默认 png。
`images`	可选数组，最多包含 16 个 HTTP(S) 图像地址。提供至少一张参考图即进入编辑模式；文生图时省略此字段。

查询任务

GET /api/status

将 TASK_ID 设置为返回的 data.task_id，以 task_id 查询参数发送，并使用同一个用户 API 密钥。

curl --get https://gptimage-26.com/api/status \
  --header "Authorization: Bearer $GPT_IMAGE_API_KEY" \
  --data-urlencode "task_id=$TASK_ID"

PENDING / IN_PROGRESS: 任务仍在执行。再次查询此接口以了解进度。
SUCCESS: 从 data.response 数组中读取生成图像的地址。
FAILED: 先查看 data.error_message 中的失败详情，再决定是否重新提交请求。

任务完成后的响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "<TASK_ID>",
    "status": "SUCCESS",
    "response": [
      "<IMAGE_URL>"
    ],
    "error_message": null
  }
}

尖括号中的值是占位符，分别表示请求实际返回的任务 ID 和图像地址。