GPT Image 2.6

GPT Image 2.6（产品 gpt_image）用提示词生成图片，可以带最多 16 张参考图。和 GPT Image 2.5 一样有两个版本（flare、sunburst）、五档质量，可以出透明背景，价格也一样；另外可以选出图格式（png、jpeg、webp、gif 动图、svg 矢量图），可以直接指定宽高（size）。一个任务出 1–4 张，按质量和分辨率按张计费。

创建任务

用所有模型共用的创建任务接口，model 传 "gpt-image-2.6"。接口通常不到 1 秒返回，几秒内按 num_outputs 张冻结费用；任务结束后获取结果。

请求头

请求体

传了其他参数（例如别的图片模型才有的 seed、remove_bg）返回 400 invalid_request，见错误。

出图格式

frame_count、frame_duration_ms 只有 gif 能传，换成别的格式时要去掉。

尺寸规则

size 不符合下面的规则时返回 400 invalid_request，param 为 "size"：

总像素不能超过 resolution 档位的上限（只看总像素，不看长边）：

要出大尺寸请调高 resolution（svg 只能用 1k，最多 1075200 像素）。size 比档位小也可以，但按所传的档位收费：4k 配 1024x768 出的是 1024×768 的图，收的是 4k 的钱，请选放得下的最低档。gif 可用的尺寸例如 288x288、512x512、768x768、512x288、288x512、912x304。

用 1 张参考图生成 2 张 16:9 的 WebP，指定 2048×1152，high 质量：

curl https://api.nanoapi.ai/v1/tasks \
  -H "Authorization: Bearer $NANOAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7c3f1e92-4a6b-4d0e-9b8f-5e2a1c7d9f34" \
  -d '{
    "model": "gpt-image-2.6",
    "prompt": "Put a red apple next to the mug in @Image1",
    "image_urls": ["https://example.com/mug.jpg"],
    "variant": "flare",
    "quality": "high",
    "resolution": "2k",
    "output_format": "webp",
    "size": "2048x1152",
    "num_outputs": 2
  }'

GIF 动图：4 帧、每帧 512×512、每帧 100 毫秒（gif 要 1k，size、frame_count、frame_duration_ms 都必传，不能传 aspect_ratio）：

curl https://api.nanoapi.ai/v1/tasks \
  -H "Authorization: Bearer $NANOAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 1b8d4f60-2e7a-4c93-a5d1-8f0e6b3c2a17" \
  -d '{
    "model": "gpt-image-2.6",
    "prompt": "A red ball bouncing up and down, simple looping animation",
    "variant": "flare",
    "quality": "low",
    "resolution": "1k",
    "output_format": "gif",
    "size": "512x512",
    "frame_count": 4,
    "frame_duration_ms": 100,
    "num_outputs": 1
  }'

方形的 SVG 标志（svg 要 1k，不能带 image_urls）：

curl https://api.nanoapi.ai/v1/tasks \
  -H "Authorization: Bearer $NANOAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 9e2a7c15-6d3b-4f8e-b0a4-3c1f5d7e9b62" \
  -d '{
    "model": "gpt-image-2.6",
    "prompt": "A flat minimalist fox logo",
    "variant": "flare",
    "quality": "medium",
    "resolution": "1k",
    "output_format": "svg",
    "aspect_ratio": "1:1",
    "num_outputs": 1
  }'

响应：200 OK。data 是刚创建的任务，只有下面这几个字段，各字段的含义见创建任务的返回。保存 data.id，用它获取结果。任务创建后仍可能失败（例如余额不够这次的费用），以查询或回调的结果为准。

{
  "code": 200,
  "message": "success",
  "data": {
    "object": "task",
    "id": "tk_01jbm2r7c5x8v1n4q6t9w3e0y2",
    "model": "gpt-image-2.6",
    "status": "queued",
    "error": null,
    "created_at": "2026-11-05T08:30:00Z"
  }
}

获取结果

耗时仅供参考（开始生成到出图，不含排队，另加几秒转存；上游忙时会更慢）：png 1k 约 20 秒，gif、svg 约 25–45 秒；质量越高、用 sunburst、带参考图都会更慢。同一个任务的多张图并行生成，出多张的总耗时和单张差不多。任务结束（成功或失败）后用下面任一方式拿结果：

• 回调（生产环境推荐）：创建时传了 webhook_url，任务结束时会把完整的任务推送一次，见回调。
• 轮询：用 data.id 调用 GET /v1/tasks/{task_id}，间隔 15 秒以上，直到 status 为 succeeded 或 failed；多个任务用列出任务的 ids 一次查询。

上面的 WebP 请求成功后（省略了其他字段）：

{
  "status": "succeeded",
  "input": {
    "prompt": "Put a red apple next to the mug in @Image1",
    "image_urls": ["https://example.com/mug.jpg"],
    "variant": "flare",
    "quality": "high",
    "resolution": "2k",
    "output_format": "webp",
    "size": "2048x1152"
  },
  "num_outputs": 2,
  "outputs": [
    {
      "index": 0,
      "type": "image",
      "url": "https://cdn.nanoapi.ai/h/tk_01jbm2r7c5x8v1n4q6t9w3e0y2_1_1793867400.webp",
      "preview_url": "https://cdn.nanoapi.ai/h/tk_01jbm2r7c5x8v1n4q6t9w3e0y2_1_1793867400_compressed.jpg"
    },
    {
      "index": 1,
      "type": "image",
      "url": "https://cdn.nanoapi.ai/h/tk_01jbm2r7c5x8v1n4q6t9w3e0y2_2_1793867400.webp",
      "preview_url": "https://cdn.nanoapi.ai/h/tk_01jbm2r7c5x8v1n4q6t9w3e0y2_2_1793867400_compressed.jpg"
    }
  ],
  "billing": {
    "currency": "USD",
    "frozen": "…", // 2 × high 2k 的每张单价
    "charged": "…", // 一样：2 张都生成出来了
    "refunded": "0.00",
    "billed_seconds": null
  }
}

失败时冻结的钱全额退回，原因在 data.error.type，见错误。完整的字段见任务对象。

出图尺寸

传 aspect_ratio 时尺寸和 GPT Image 2.5 一样，见 GPT Image 2.5 → 出图尺寸；quality、variant、output_format 不影响尺寸，auto 的尺寸取决于参考图。传 size 时按 size 出图（gif 是每一帧的尺寸）。

张数比请求的少

每张图单独生成。有几张没生成出来（例如被内容审核拦下）时，任务仍是 succeeded，outputs 里只有生成出来的那几张，比 num_outputs 少。只按这几张扣费，冻结的其余部分退回（billing.refunded）。一张都没生成出来时任务才是 failed，冻结的钱全额退回：其中只要有 1 张是被内容审核拦下的，失败原因就是 content_policy（不一定每张都被拦），否则一般是 generation_failed。outputs[].index 按生成出来的那几张从 0 连续编号，张数比请求的少时不对应请求里的第几张，不要按它去对位。

素材

参考图以公开的 http(s) 链接放在 image_urls 里提交。不提供上传接口，请自行托管文件。链接最长 4096 字符，必须能直接下载，不能指向 localhost 或内网、回环、保留地址。

任务结束前所有链接都要保持可访问，有有效期的链接也不能提前过期。

在提示词里引用图片

• 引用超出了传入的张数（例如只传了 1 张却写了 @Image2，或者没传 image_urls 却写了 @Image）：返回 400 invalid_request，param 为 "prompt"，任务不会创建。
• @ 前面是字母、数字或点的不算引用，所以提示词里写邮箱（例如 bob@image2go.com）没有问题。

价格

冻结 = 所选质量和分辨率的每张单价 × num_outputs
扣费 = 所选质量和分辨率的每张单价 × 生成出来的张数

正在读取当前价格…

• 和 GPT Image 2.5 同价：两个模型都在产品 gpt_image 里，共用它的价格行。
• 只有 quality 和 resolution 影响价格；variant、output_format、size、aspect_ratio、帧数和每帧时长、background、参考图都不影响。
• size 不会让价格变低：比 resolution 档位小的尺寸按档位收费，见尺寸规则。
• 创建后几秒内按 num_outputs 张冻结。成功后按生成出来的张数扣费，其余退回，见张数比请求的少；失败全额退回。

例如上面的 WebP 请求（high、2k，num_outputs 为 2）冻结 2 × high 2k 的每张单价，2 张都生成出来时扣同样的金额；GIF 请求冻结 1 × low 1k 的每张单价，和帧数无关。冻结和扣费的通用规则见计费。

价格只看请求就能算出来，可以在提交前显示：用 GET /v1/products 返回的当前单价计算（产品 gpt_image，prices 里每个 quality 和分辨率一行）。价格会调整，不要写死；实际费用以查询任务返回的 billing.frozen 为准。

错误

这个模型特有的错误和失败原因。创建任务的全部错误见创建任务 → 错误，全部失败原因见失败原因。

创建请求出错：请求返回 HTTP 错误，任务不会创建。param 是对应的参数名，message 是英文说明，可以直接展示给你的用户。

创建接口的其他错误（401、402、429 等）见创建任务 → 错误。

任务失败：创建请求成功（200），任务之后变成 failed。这种情况没有 HTTP 状态码，原因在任务的 error.type，通过查询任务或回调拿到。

所有失败的任务都已全额退回冻结金额，billing.charged 为 "0.00"。