GPT Image 2.5

使用官方分组 API Key。Flare 和 Sunburst 使用各自的公开模型 ID；不要把它们写成 GPT 文字模型的 Responses 工具调用。

支持的协议

使用 JSON POST /v1/images/generations 生成图片，使用 POST /v1/images/edits（multipart/form-data）上传文件编辑。提交返回 202 Accepted 和任务 id，之后轮询 GET /v1/tasks/{id}，直到 completed 或 failed。202 不表示已经出图。

本系列使用 Images + 异步任务，不支持通过 /v1/chat/completions 或 /v1/responses 生成图片。完整示例见提交并轮询。

模型与参数

size 表示宽高比，例如 1:1、16:9；resolution 选择分辨率。quality 支持 auto、low、medium、high、xhigh、max。示例选 low；提示词最多 4000 字符。可将示例模型换成 gpt-image-2.5-sunburst。

生成图片

先将 APIPOOL_API_KEY 设置为自己的 Key，再运行示例：

APIPOOL_ENDPOINT="https://app.apipool.dev"

curl "$APIPOOL_ENDPOINT/v1/images/generations" \
  -H "Authorization: Bearer $APIPOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "A blue ceramic cup on a white table",
    "size": "1:1",
    "resolution": "1k",
    "n": 1,
    "quality": "low"
}'

编辑图片

上传本地 PNG、JPEG 或 WebP 文件；把 source.png 换成实际文件路径：

curl "https://app.apipool.dev/v1/images/edits" \
  -H "Authorization: Bearer $APIPOOL_API_KEY" \
  -F "model=gpt-image-2.5-flare" \
  -F "prompt=Change the cup to green" \
  -F "image=@./source.png" \
  -F "size=1:1" \
  -F "resolution=1k" \
  -F "n=1"

多张参考图可重复 -F "image=@./second.png"，不得超过模型上限。 已有可公开下载的参考图时，也可在同一个 JSON 生成接口中传 image_urls：

{
  "model": "gpt-image-2.5-flare",
  "prompt": "Change the cup to green",
  "size": "1:1",
  "resolution": "1k",
  "n": 1,
  "quality": "low",
  "image_urls": ["https://your-cdn.example/source.png"]
}

把示例 URL 换成服务端可访问的真实地址。临时隧道失效、DNS 解析失败或下载超时 会导致任务失败；不要使用仅自己的浏览器可访问的本机或登录态地址。

查询与获取结果

保存提交响应中的 id（例如 imgtask_01...），使用提交时同一个 Key 查询：

TASK_ID="imgtask_01..."
curl "https://app.apipool.dev/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $APIPOOL_API_KEY"

submitted、submission_unknown、processing、meter_pending 时继续查询； completed 时读取 data[].url 并在有效期内下载；failed 时读取 error。 不要因为尚未完成就重复提交。完整状态、超时处理和可运行轮询示例见 图片异步任务。

范围与计费

本站以异步任务交付图片。不要把普通 OpenAI SDK 的同步 Images 返回结构套用到这里；必须读取任务 ID 并轮询。

按所选模型的 Token 单价和实际用量计费，完成结果带标准化 usage。当前费率见模型与价格。