将基本图像调用从 GPT Image 2.5 迁移到 2.6，只需更改模型 ID。端点相同，token 费率相同，三个推荐尺寸也相同。需要留意的是 Batch：2.5 支持，2.6 不支持；Responses 图像工具：OpenAI 对 2.5 和 2.6 的资料描述不一；以及复杂度、SVG、GIF 和标记这些控制项：OpenAI 的 Image API 文档中有说明，但目前还未出现在 AIHubMix 已发布的参数 schema 中。
本教程将通过 AIHubMix 演示一个典型任务：制作一张带标题和产品图的 1536x1024 海报。流程从用 Flare 生成三张低成本草稿开始，选出一张，再用 Sunburst 渲染成品，并为每个步骤列出成本。过程中也会介绍那些不会明显报错、却会悄悄导致问题的迁移陷阱。
保持不变的部分
2.6 的两款模型是 gpt-image-2.6-sunburst 和 gpt-image-2.6-flare。两者都通过 v1/images/generations 和 v1/images/edits 调用；两者都没有通用的 gpt-image-2.6 别名。文本输入价格为每百万 token $5，图像输入为 $8，图像输出为 $30，与 2.5 和 GPT Image 2 完全相同。
这意味着，基于 Image API 构建的流水线可以沿用原有请求结构。变化的是模型字符串，而且只有在你想使用新模型时才需要更改。根据 AIHubMix 模型页面的说法，这个系列速度提升了 50%；这是首日迁移的主要理由。
迁移注意事项
不再支持 Batch
这是 2.5 优势最明显的一项功能。GPT Image 2.5 的模型页面列出了对 v1/batch 的支持，而且 Batch 的图像输出价格为每百万 token $15，而非 $30。GPT Image 2.6 的模型页面则注明不支持 Batch，Batch 定价表也没有列出这两款 2.6 模型。
如果你会在夜间运行图像任务，不要将它们迁移到 2.6。可以继续使用 2.5，或拆分工作负载：交互式草稿用 2.6，批量渲染用 2.5。AIHubMix 的图像文档没有列出 Batch 端点，因此这个决定只适用于直接调用 OpenAI 的情况。
Responses 流水线需要检查
OpenAI 自己的资料对 2.5 在这方面说法不一。9 月的更新日志将 Responses API 图像生成工具与 Image API 并列列出，但 2.5 模型页面标注为不支持 Responses。2.6 的情况则更明确：模型页面标注为不支持 Responses，11 月的更新日志仅列出 v1/images/generations 和 v1/images/edits。
如果你的代码通过 Responses 调用 2.5，在更改模型 ID 之前先添加冒烟测试。这种情况会明确报错，但前提是你做了测试；如果流水线悄悄回退到其他模型，那比收到 400 错误更糟。
新控制项仅适用于 Image API
图像生成指南将 complexity、标记引导编辑、SVG 输出和动态 GIF 输出列为 Image API 的功能。这些功能都无法通过 Responses 图像工具使用；而 SVG 和 GIF 仅支持生成，不能用于 /v1/images/edits。
每项功能都有自己的限制。SVG 要求 n=1，且不支持流式输出、部分图像、output_compression 或 prompt_rewriter。GIF 使用 frame_count（默认值为 9）和 frame_duration_ms（默认值为 200），仅支持生成，也不支持流式输出、部分图像、自定义 output_compression 或 prompt_rewriter。标记编辑需要将原图作为第一张输入图像，并提供一张尺寸相同的独立透明 PNG；两张图都不得超过 16,777,216 像素，标记文件大小上限为 50 MB。不要将 markup 与 mask 或 prompt_rewriter 一起使用。
SVG 还有一项计费规则：参考图像按图像模型费率计费，生成 SVG 所用的 token 则按创作模型费率计费。总费用取决于两者，因此常规的单张图像费用估算并不适用。
质量和尺寸文档说法不一
对于 2.5，OpenAI 除 auto 外，还明确记录了五个质量等级：low、medium、high、xhigh 和 max。对于 2.6，指南中的成本计算器为两代模型都列出了这五种等级；API 参考文档仅将 xhigh 和 max 列在 2.5 快照模型下；而 AIHubMix 的单图定价表（下文成本数据的来源）只对 low、medium、high 和 auto 标价。
目前使用 2.6 时，稳妥的选项是 low、medium、high 和 auto。尺寸也要采取同样的谨慎做法：GPT Image 2 和 2.5 的文档支持自定义 WIDTHxHEIGHT 值，而 2.6 指南推荐 1024x1024、1536x1024 和 1024x1536。在 2.6 的文档统一之前，请使用这三个推荐尺寸。
从 1.5 迁移时，1024x1024 的 high 质量会更贵
GPT Image 1.5 和 1-mini 将于 2026 年 12 月 1 日下线，官方指定 2.5 为替代型号。如果你主要以 1024x1024 和 high 质量渲染，迁移并不便宜：OpenAI 的 1.5 定价表中，high 质量价格为 $0.133；AIHubMix 对 2.6 的估价为 $0.211，约贵 59%。medium 质量的价格从 $0.034 涨至 $0.053；low 质量则从 $0.009 降至 $0.006。在 1536x1024 尺寸下，1.5 的 high 质量价格为 $0.200，因此 2.6 的 $0.165 在该尺寸下更便宜。
在认定 2.6 更贵之前，先用相同的工作负载在 2.5 上跑一遍：token 费率相同，因此两款 2.x 模型之间的费用差异来自 token 消耗量，而非标价。
通过 AIHubMix 调用 2.6
AIHubMix 提供这两款 2.6 模型，定价与官方费率一致。AIHubMix 的图像生成文档介绍了较新的端点：POST https://aihubmix.com/ai/v1/images/generations。该端点接受 model、prompt、n、size、output_format、image、images、mask、async、extra 以及两个 webhook 字段。
关键在于 quality 参数的位置。在 /ai/v1/images/generations 中没有顶层 quality 字段；它应放在 extra 中：
curl -s https://aihubmix.com/ai/v1/images/generations \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.6-flare",
"prompt": "A minimal poster: a single ceramic coffee mug on a pale sand background, soft morning light, large empty space at the top for a headline",
"size": "1024x1024",
"n": 3,
"extra": { "quality": "low" }
}'
响应中会包含一个或多个输出 URL。这些 URL 的有效期很短，约为 30 分钟；下载时必须使用同一个 Authorization: Bearer $AIHUBMIX_API_KEY 请求头：
curl -s -H "Authorization: Bearer $AIHUBMIX_API_KEY" "<output-url>" -o draft-1.png
AIHubMix 文档建议新集成使用 /ai/v1：与 OpenAI 兼容的 /v1 端点可能尚不支持最新模型，而旧版图像参考文档中的模型列表包括 gpt-image-2、gpt-image-1.5、gpt-image-1-mini 和 DALL·E 系列，但不包括 2.6。各模型的 schema 确实列出了 2.6 的 /v1/images/generations 条目，但 AIHubMix 文档为 2.6 指定的调用路径是 /ai/v1，而且该路径还支持异步任务和 webhook。
schema 尚未公开的功能
AIHubMix 已发布的 2.6 schema 仅接受 output_format、png 和 jpeg 作为 webp 的值。它没有 complexity、markup、frame_count 或 frame_duration_ms，也不支持 svg 或 gif 输出。无需身份验证即可在 https://aihubmix.com/call/schema/models/gpt-image-2.6-flare/endpoints 查看 schema；若要通过网关使用上述任何功能，应先检查该 schema。
这是 schema 尚未覆盖相关功能，并非实测失败：OpenAI 已经记录了这些功能，网关日后也可能会支持。在 schema 列出这些功能之前，请计划直接调用 OpenAI 来完成 SVG、GIF 和标记相关工作。
需要留意的错误
| 状态码 | 含义 | 处理方法 |
|---|---|---|
| 400 | 参数错误，通常由供应商返回 | 检查 prompt、size 和 n |
| 401 | 密钥缺失或无效 | 检查 Authorization 请求头 |
| 402 | 配额不足 | 充值 |
| 403 | 权限被拒绝 | 检查账户、密钥权限和 IP 限制 |
| 429 | 触发速率限制 | 暂停一段时间后重试 |
| 503 | 没有可处理该请求的渠道 | 检查模型 ID，稍后重试 |
AIHubMix 的错误响应体中包含 tid 跟踪 ID。请保留该 ID 以便联系支持；400 错误不要原样重试。这是 /ai/v1 的约定；旧版 /v1 端点会用 403 insufficient_user_quota 表示配额不足。
工作流程：三张草稿，一张成品
任务是制作一张带产品图和标题的海报。提示词保持不变，只调整模型、尺寸和质量。
步骤 1 — 使用 Flare 生成草稿。用一次请求在 1024x1024 尺寸和 low 质量下设置 n=3，即可得到三个方案。估算每张图像 $0.006，这一步的成本为 $0.018。
步骤 2 — 选出一个方案。这是整个流程中成本最低的一步，也是最能受益于模型速度提升的一步。一次调用生成三张草稿属于常规预算，并非奢侈花费。
步骤 3 — 使用 Sunburst 渲染成品。针对选定的构图重新编写提示词，以 1536x1024 尺寸和 high 质量渲染。这是成本最高的一步，估算每张图像 $0.165；一张成品约等于 28 张草稿的成本，或三张草稿总成本的约九倍。
curl -s https://aihubmix.com/ai/v1/images/generations \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.6-sunburst",
"prompt": "A minimal poster: a single ceramic coffee mug on a pale sand background, soft morning light, large empty space at the top for a headline. Refined studio product photography, subtle shadow, no text",
"size": "1536x1024",
"n": 1,
"extra": { "quality": "high" }
}'
步骤 4 — 计算总成本。草稿估算花费 $0.018，加上成品的 $0.165，为四张输出图像合计 $0.183。如果成品改用 medium 质量渲染，费用为 $0.041，整次任务的总费用就是 $0.059。按照这种提示词的长度，输入文本 token 只会增加不到一美分的费用；编辑图像则会按每百万 token $8 的费率增加图像输入费用。
这个数字说明两款模型之间没有成本差异：在 2.5 上生成同样四张图像，费用相同，因为 AIHubMix 的单图估算一致。使用 2.6 的理由是草稿迭代更快，以及日后可以改用 OpenAI 处理 SVG 或 GIF，而不是账单更低。
迁移检查清单
- 在需要使用新模型的地方，将
gpt-image-2.5-sunburst和gpt-image-2.5-flare替换为对应的 2.6 ID；Batch 任务则继续使用 2.5。 - 确认是否有任何流水线使用 Responses 图像工具；2.6 的文档仅说明支持 Image API。
- 在 2.6 文档稳定下来之前，quality 仅使用
low、medium、high或auto，尺寸也仅使用三个推荐值。 - 在 AIHubMix 的
/ai/v1上，将质量参数放在extra中；对于 2.6，请使用/ai/v1，这是 AIHubMix 为新集成推荐的路径。 - 请在 30 分钟内下载输出 URL，并携带 Bearer 请求头。
- 在架构定义列出之前，不要假设
complexity、markup、SVG 或 GIF 能通过 AIHubMix 使用。 - 如果你正在使用 1.5，请为 12 月 1 日的下线做好准备，并重新核对高质量图像的成本。
常见问题
使用 GPT Image 2.6 时需要更改端点吗？
在 OpenAI API 上不需要。它使用 v1/images/generations 和 v1/images/edits，与 2.5 相同；只有模型 ID 会改变。在 AIHubMix 上，请按上文所述使用 /ai/v1/images/generations。
GPT Image 2.6 比 2.5 便宜吗？
不便宜。token 费率完全相同：每百万个文本输入 token 收费 $5，每百万个图像输入 token 收费 $8，每百万个图像输出 token 收费 $30。
为什么我不能对 GPT Image 2.6 使用 Batch？
OpenAI 的 2.6 模型页面标明不支持 Batch，Batch 定价表中也列出了 2.5，但没有 2.6。Batch 是 2.5 仍然更适合的最明确场景。
如何在 AIHubMix 上设置质量参数？
对于 2.6，在 /ai/v1/images/generations 上将其放入 extra.quality。与 OpenAI 兼容的 /v1/images/generations 使用顶层 quality 字段，但 AIHubMix 建议新集成使用 /ai/v1；对于 2.6，请使用 /ai/v1。
我可以通过 AIHubMix 生成 SVG 或 GIF 吗？
根据当前架构定义，不可以。该定义列出了 png、jpeg 和 webp，但不包含 complexity、markup、帧数或 SVG/GIF 输出。这些功能在 OpenAI 的图像 API 文档中有说明；通过网关使用前，请先查看架构定义。
AIHubMix 的输出 URL 有效期是多久？
大约 30 分钟。请使用相同的 Bearer token 下载，并自行保存文件。
GPT Image 1.5 会怎么样？
它将于 2026 年 12 月 1 日下线。OpenAI 指定 2.5 为替代模型，但在 1024x1024 分辨率下，2.6 的高质量图像单价高于 1.5；在 1536x1024 分辨率下则更低。
继续阅读：GPT Image 2.6 系列
对比文章介绍了价格表、速度方面的说法，以及 2.5 仍然占优的场景；如果你还没决定是否迁移，可以从这里开始阅读。
GPT Image 2.6 与 2.5 对比：值得升级吗？
