GPT Image 2

特惠分组 · model: gpt-image-2 · 按实际交付张数计费

本页面向创建于特惠分组的 API Key。分组由 Key 决定，请求里始终填公开模型 ID gpt-image-2，不要额外加 group 字段。

概览

项目	特惠分组行为
API Key	必须属于特惠分组
公开模型 ID	`gpt-image-2`
提交方式	异步提交，返回 `202 Accepted`
计费依据	实际成功交付图片数 × `resolution` 档位
价格	模型列表中的特惠分组 1K、2K、4K 单价

生成图片

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",
    "prompt": "An editorial photograph of a green leaf",
    "size": "1:1",
    "resolution": "2k",
    "n": 1
  }'

编辑上传图片

上传文件时用 multipart/form-data：

curl "$APIPOOL_ENDPOINT/v1/images/edits" \
  -H "Authorization: Bearer $APIPOOL_API_KEY" \
  -F "model=gpt-image-2" \
  -F "prompt=Change the blue circle to green" \
  -F "image=@./source.png" \
  -F "size=1:1" \
  -F "resolution=4k" \
  -F "n=1"

请求参数

字段	必填	取值与含义
`model`	是	始终为 `gpt-image-2`
`prompt`	是	图片生成或编辑指令
`image`	文件编辑时必填	在 `/v1/images/edits` 上传一张源图片
`size`	否	输出宽高比，例如 `1:1`
`resolution`	建议显式传入	计费与输出档位：`1k`、`2k` 或 `4k`；省略、`auto` 和 `1k` 走默认档位
`n`	否	当前公开支持值为 `1`；默认 `1`

建议显式写 resolution，让输出档位和计费档位保持明确。特惠分组当前只公开单张输出，n 传 1 或直接省略。图片接口不支持 stream: true。

提交与轮询

提交接口返回的是任务，不是已完成的图片：

{
  "id": "imgtask_01...",
  "object": "image_generation.task",
  "status": "submitted",
  "model": "gpt-image-2",
  "created_at": 1787068800
}

用同一个 API Key 轮询任务：

TASK_ID="imgtask_01..."

curl "$APIPOOL_ENDPOINT/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $APIPOOL_API_KEY"

完整的状态值、轮询规则、临时下载地址和可重试响应见图片异步任务。

完成任务

{
  "id": "imgtask_01...",
  "object": "image_generation.task",
  "status": "completed",
  "model": "gpt-image-2",
  "created_at": 1787068800,
  "completed_at": 1787068842,
  "data": [
    {
      "url": "https://objects.example/results/0.png?...",
      "expires_at": 1787072442
    }
  ],
  "result_expires_at": 1787155242
}

特惠分组不返回 token usage，data 数组本身就是交付凭据。

计费

按 data 中成功交付的图片数量计费，档位用提交时锁定的 resolution。当前 1K、 2K、4K 单价以模型列表的特惠分组为准。

需要 token 计费和标准化 usage，改用官方分组的 Key。