> https://router.one/zh/blog/gpt-image-2-6-api-guide 的 Markdown 镜像，供 AI 助手与爬虫使用。Router One 是 OpenAI 兼容的统一 LLM API 网关。
> 发布：2026-11-10 · 作者：Router One Team

# GPT Image 2.6 API 接入指南：国内调用、Flare 与 Sunburst

_国内直连调用 GPT Image 2.6：gpt-image-2.6-flare 与 gpt-image-2.6-sunburst 两个模型 ID、请求写法、按张从钱包扣费，以及 Flare 与 Sunburst 怎么选。_

截至 2026-11-05 的模型目录，Router One 以 `gpt-image-2.6-flare` 与 `gpt-image-2.6-sunburst` 两个模型 id 列出 GPT Image 2.6，2026-11-10 的模型目录里两者仍在。国内开发者不需要 VPN：用 Router One 的 Key 把其中一个 id 填进 `model`，发到 `POST https://api.router.one/v1/images/generations`，请求格式遵循 OpenAI Images API，和网关上的其他生图模型一样。按 2026-11-10 的目录，两个 id 都是每张 $0.10；生图调用从钱包扣费：2026-11-10 的套餐接口里没有任何档位列出图像模型。

本文依次讲清：这两个 id；OpenAI 官方对它们的说明；按 OpenAI 的原话，Flare 与 Sunburst 有什么不同；它们和 GPT Image 2.5、gpt-image-2 的关系；怎么计费；怎样用 curl 与 OpenAI Python SDK 发出第一个请求；以及这个端点会返回哪些错误。文中的目录、套餐信息与 OpenAI 的说法都注明了日期，发起新请求前以实时目录为准。

## GPT Image 2.6 速览

| 项目 | 目录所列（2026-11-10） |
| --- | --- |
| 模型 id | `gpt-image-2.6-flare`、`gpt-image-2.6-sunburst` |
| 首次看到 | 2026-11-05 的模型目录（16:05 UTC 那次读取）；目录没有标注发布日期 |
| 输入 / 输出 | 文本输入，图像输出 |
| 端点 | `POST /v1/images/generations`（OpenAI Images API 格式） |
| 单价 | 两个 id 都是每张 $0.10（2026-11-10 的目录） |
| 套餐 | 2026-11-10 的套餐接口里没有任何档位列出图像模型，每张图都从钱包扣费 |
| 模型页 | [GPT Image 2.6 Flare](https://router.one/zh/models/gpt-image-2-6-flare)、[GPT Image 2.6 Sunburst](https://router.one/zh/models/gpt-image-2-6-sunburst) |

## OpenAI 官方怎么说明 GPT Image 2.6

按 OpenAI 的 [API 更新日志](https://developers.openai.com/api/docs/changelog)（2026 年 11 月 4 日条目，2026-11-10 核对），OpenAI 发布了 GPT-Image-2.6 Sunburst 与 GPT-Image-2.6 Flare，用于生图与改图，支持可调的 complexity、SVG 生成与 GIF 动图生成；同时为支持的 GPT Image 2.5 与 2.6 模型加入了按标注改图（markup-guided editing）。OpenAI 的模型页（2026-11-10 核对）这样介绍两者：

- **[GPT-Image-2.6 Flare](https://developers.openai.com/api/docs/models/gpt-image-2.6-flare)**：面向快速迭代的生图与改图模型；OpenAI 建议用于交互式的生图与改图流程。
- **[GPT-Image-2.6 Sunburst](https://developers.openai.com/api/docs/models/gpt-image-2.6-sunburst)**：面向注重细节的视觉作品的生图与改图模型；OpenAI 建议用于注重细节的构图与改图流程。

OpenAI 的[图像生成指南](https://developers.openai.com/api/docs/guides/image-generation)（2026-11-10 核对）还写明：在 OpenAI 自家的 Image API 上，两者都接受 `complexity` 字段（`low`、`medium` 或 `high`，不传时为 `high`），也能输出 SVG 与 GIF 动图；GPT Image 2.6 与 2.5 的 Sunburst、Flare 可选的 quality 为 `low`、`medium`、`high`、`xhigh` 与 `max`。

以上是 OpenAI 对自家 API 的说法；Router One 负责的是目录条目本身，以及网关如何提供和计费。2026-11-10 的目录为这两个 id 列出的是文本输入、图像输出，模型页只列出一个端点 `POST /v1/images/generations`；Router One 的 [Images API 文档](https://router.one/zh/docs/images/createImageGeneration)为这个端点列出 `model`、`prompt`、`n`、`size`、`quality` 与 `response_format` 这几个字段。按文档，Router One 会把 `size` 与 `quality` 原样传给模型、不做校验，模型不接受的取值会返回 400。本文只讲这几个字段。

## Flare 还是 Sunburst？

OpenAI 对两者的区别各用一句话说明：Flare 面向快速迭代，Sunburst 面向注重细节的视觉作品（模型页与图像生成指南，2026-11-10 核对）。在 Router One 上，两个 id 的请求格式相同，按 2026-11-10 的目录也都是每张 $0.10，所以选哪个看出图效果，不看预算：

- 打磨 prompt 时先用 **Flare**，把选中的 prompt 再交给 **Sunburst**，留下评审更认可的那一版。
- 切换只改一个字符串：同一把 Key、同一个端点，换 `model` 即可。
- 网关发往模型的每次请求，控制台 → 日志都会记下模型、钱包扣费、延迟与状态（[每请求可观测](https://router.one/zh/llm-observability)），两个 id 的请求可以放在一起对照。

## GPT Image 2.6、GPT Image 2.5 与 gpt-image-2

- **发布先后。** 按 OpenAI 的更新日志（2026-11-10 核对），GPT Image 2.5 的 Sunburst 与 Flare 于 2026 年 9 月 8 日发布，GPT Image 2.6 的 Sunburst 与 Flare 于 2026 年 11 月 4 日发布。OpenAI 的图像生成指南把 `gpt-image-2` 列在较早的 GPT Image 模型里。
- **在 Router One 上。** 按 2026-11-10 的目录，五个 GPT Image id 都在列（`gpt-image-2`、`gpt-image-2.5-flare`、`gpt-image-2.5-sunburst`、`gpt-image-2.6-flare` 与 `gpt-image-2.6-sunburst`），都走 `POST /v1/images/generations`，都是每张 $0.10。
- **从 2.5 换到 2.6。** 请求里只换模型字符串：`gpt-image-2.5-flare` 换成 `gpt-image-2.6-flare`，`gpt-image-2.5-sunburst` 换成 `gpt-image-2.6-sunburst`。2026-11-10 的目录里 2.5 的两个 id 仍在；迁移前先用自己的 prompt 在两个版本上都跑一遍。

## 怎么计费

- **按张计费。** 按 2026-11-10 的目录，`gpt-image-2.6-flare` 与 `gpt-image-2.6-sunburst` 都是每张 $0.10，生成的图像不算 token。每生成一张图算一次：`n: 2` 是请求两张，按响应里 `data` 数组实际返回的图计费（[Images API 文档](https://router.one/zh/docs/images/createImageGeneration)）。
- **套餐。** 按 2026-11-10 的套餐接口，Router One 的 Pro、Max、Ultra 套餐里没有任何档位列出图像模型，所以不管有没有套餐，GPT Image 2.6 的调用都从钱包扣费，钱包里要有余额。
- **按 Key 设上限。** 给生图流水线单独发一把带 `maxSpend` 上限的 Key（[按 Key 核算](https://router.one/zh/llm-cost-tracking)）。每把 Key 的消费上限（maxSpend）限的是这把 Key 能从钱包扣的钱：累计扣费到上限后，这把 Key 上需要钱包付费的请求返回 HTTP 402。套餐额度覆盖的请求从账户共用的套餐额度里扣，不计入任何 Key 的上限。
- **记录。** 网关发往模型的每次生图请求，控制台 → 日志都会显示模型、钱包扣费、延迟与状态；在那之前就被拒绝的请求（例如 401、402）不留记录。

实时单价见模型页：[GPT Image 2.6 Flare](https://router.one/zh/models/gpt-image-2-6-flare) 与 [GPT Image 2.6 Sunburst](https://router.one/zh/models/gpt-image-2-6-sunburst)。

## 发出第一个请求

1. **创建 Key。** 控制台 → API 密钥 → 创建密钥，Key 形如 `sk-...`。
2. **给钱包充值。** 支付宝或银行卡在同一个托管收银台完成充值，也支持 6 条链上的 USDT/USDC（Tron、BSC、以太坊、Polygon、Base、Arbitrum），无需美国信用卡。支付宝充值的步骤见[支付宝充值页](https://router.one/zh/alipay-llm-api)。
3. **调用端点**，把其中一个 id 填进 `model`。

```bash
export ROUTER_ONE_KEY=sk-your-router-one-key

curl -X POST https://api.router.one/v1/images/generations \
  -H "Authorization: Bearer $ROUTER_ONE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-image-2.6-flare",
       "prompt": "陶瓷茶壶的平铺产品图，柔和的晨光"}'
```

用官方 OpenAI Python SDK 时，把 `base_url` 指向网关：

```python
import base64, httpx
from openai import OpenAI

client = OpenAI(base_url="https://api.router.one/v1", api_key="sk-your-router-one-key")

result = client.images.generate(
    model="gpt-image-2.6-sunburst",
    prompt="夜晚的城市街景海报，简单色块，不要文字",
    n=2,
)

for i, item in enumerate(result.data):
    png = base64.b64decode(item.b64_json) if item.b64_json else httpx.get(item.url).content
    with open(f"poster-{i}.png", "wb") as f:
        f.write(png)
```

Router One 的文档写明两种返回形式：`url`（默认，链接约一小时后失效）与 `b64_json`（设置 `response_format`）。像上面那样两种都处理，拿到后立即保存。这个调用是同步的，生成完成才返回，客户端超时请设得宽松一些，不要设得很紧。

## 常见错误

这个端点返回网关统一的错误结构（`error` 下的 `message`、`type`、`code` 与 `request_id`）；完整列表见[错误码页](https://router.one/zh/llm-api-error-codes)。生图请求最常遇到的是：

| 状态码 | 错误码 | 怎么处理 |
| --- | --- | --- |
| 400 | `INVALID_REQUEST` | 模型 id 写错或不在目录（`requested model is not available`）、缺少 prompt、字段格式不对，或者模型不接受某个 `size`、`quality` 取值（`invalid request (upstream rejected with status 400)`）。从 [/models](https://router.one/zh/models) 复制 id，去掉模型不接受的取值。 |
| 400 | `CONTENT_FILTERED` | prompt 未通过内容审核（`prompt rejected by content moderation`）。不会调用任何模型，也不计费；改写 prompt，不要自动重试。 |
| 401 | `AUTH_INVALID_API_KEY` | Key 缺失或错误：按 `Authorization: Bearer sk-…` 发送。 |
| 402 | `INSUFFICIENT_BALANCE` 或 `API_KEY_SPEND_CAP_EXCEEDED` | 钱包余额用完，或这把 Key 达到 `maxSpend` 上限。充值不会提高 Key 的上限。 |
| 429 | `RATE_LIMIT_EXCEEDED` | 按自己的退避策略重试：按 API 文档，图像端点不返回限流响应头，也不返回 `Retry-After`。 |
| 502 | `MODERATION_UNAVAILABLE` | 内容审核暂时不可用，请求被拒绝，而不是在未审核的情况下生成；稍后重试。 |
| 503 | `PROVIDER_UNAVAILABLE` | 上游暂时不可用；稍后重试。 |

## 常见问题

**Router One 上 GPT Image 2.6 的模型 ID 是什么？**
`gpt-image-2.6-flare` 与 `gpt-image-2.6-sunburst`，按 2026-11-10 的目录两者都在列，2026-11-05 的目录里首次看到。把其中一个填进 `POST /v1/images/generations` 的 `model`。

**GPT Image 2.6 在 Router One 上多少钱？**
按 2026-11-10 的目录，两个 id 都是每张 $0.10，从钱包扣费。实时单价见各自的模型页。

**订阅套餐包含 GPT Image 2.6 吗？**
不包含。按 2026-11-10 的套餐接口，Pro、Max、Ultra 套餐里没有任何档位列出图像模型，所以 GPT Image 2.6 的每张图都从钱包扣费。

**选 Flare 还是 Sunburst？**
OpenAI 把 Flare 说明为面向快速迭代的 GPT Image 2.6 模型，把 Sunburst 说明为面向注重细节的视觉作品的模型（2026-11-10 核对）。在 Router One 上两者请求格式相同、单价相同，用自己的 prompt 两边都跑一遍，对比出图再定。

**从 GPT Image 2.5 换过来，只改模型 ID 就行吗？**
是的，请求格式不变：把 `gpt-image-2.5-flare` 换成 `gpt-image-2.6-flare`，或把 `gpt-image-2.5-sunburst` 换成 `gpt-image-2.6-sunburst`。2026-11-10 的目录里 2.5 的两个 id 仍在。

**在 Router One 上能用 GPT Image 2.6 做参考图改图吗？**
OpenAI 的模型页写的是 OpenAI 自家 API 上支持改图。Router One 2026-11-10 的目录为这两个 2.6 id 列出的是文本输入。要在 `POST /v1/images/edits` 上用参考图改图，请选目录里输入模态含图像的模型，例如 `gemini-nano-banana-2.1`；哪些模型支持，见[生图 API 页](https://router.one/zh/image-generation-api)。

**国内能直连吗？**
能。端点在大陆免翻墙可达，钱包可以用支付宝或银行卡在同一个托管收银台充值，也可以用 6 条链上的 USDT/USDC。

## 结论

对已经在用网关的人来说，GPT Image 2.6 就是换一个模型字符串：把 `gpt-image-2.6-flare` 或 `gpt-image-2.6-sunburst` 填进 `model`，把 prompt 发到 `POST /v1/images/generations`，返回的 `b64_json` 或 `url` 拿到就保存。按 2026-11-10 的目录，两个 id 都是每张 $0.10，从钱包扣费。完整的生图阵容见[生图 API 页](https://router.one/zh/image-generation-api)，国内访问与付款见[国内生图 API 指南](https://router.one/zh/blog/image-generation-api-china-guide)。

## 相关页面

- 本页规范地址：https://router.one/zh/blog/gpt-image-2-6-api-guide
- 生图 API：https://router.one/zh/image-generation-api
- LLM API 支付：https://router.one/zh/wechat-pay-llm-api
- 全部博客文章：https://router.one/zh/blog
- 模型与每模型 token 价格：https://router.one/zh/models （markdown：https://router.one/zh/models.md ）
- 定价：https://router.one/zh/pricing
- API 文档（markdown）：https://router.one/zh/docs.md
- 公司事实（markdown）：https://router.one/zh/facts/company.md