Skip to main content
gpt-image-2.5-flaregpt-image-2.5-sunburst 官转已上线,接入方式沿用 gpt-image-2 官转的 Images API。优先速度选 Flare,优先精细图像编辑选 Sunburst;也可以在产品中提供两个选项,让用户自行选择。两者按 tokens 计费,token 单价与 gpt-image-2 官转相同。 另有 gpt-image-2.5-flare-vipgpt-image-2.5-sunburst-vip 两个 VIP 按次模型,均为 $0.03/次,接入方式同 gpt-image-2-vip 更新日期:2026 年 9 月 9 日。 老张API上线与分组说明依据本次服务上线通知;VIP 文生图参数已于同日完成代表性实测;模型定位、快照和官方计费依据见文末来源。

先选择接入线路

先确定线路和扣费类型,再复制对应示例。已有 GPT Image 2 集成可继续参考 GPT Image 2 文档

GPT Image 2.5 官转模型与分组

一般接入使用不带日期的别名;需要固定版本时可使用表中的完整快照 ID。别名当前映射不代表未来永远固定。
  1. 令牌管理选择按量计费,确认令牌允许调用目标模型。
  2. 两个 2.5 模型使用官转分组。普通官转选择 Sora2Official;优先稳定性的生产调用选择企业官转分组(上线通知称 image2Enterprise)。Default 分组继续使用 gpt-image-2-web,对应 GPT 网页版最新的 2.5。
  3. 保留原有官转 Images API 的鉴权、请求结构和结果处理,将 model 改为上述别名或快照 ID。分组名不填入 model
公开价格目录于 2026 年 9 月 9 日列出的两个官转模型及其快照分组为 sora_officialGPT_Image_2_Enterprise,企业组显示名为 GPTImage2 Sora2 Enterprise。创建令牌时按控制台当前选项确认对应官转分组;Default 令牌调用 VIP 模型时必须使用带 -vip 后缀的 ID,不能调用不带后缀的官转模型。

GPT Image 2.5 官转最小接入

以下示例沿用官转的文生图 /v1/images/generations 和图像编辑 /v1/images/edits。SDK 对应 images.generateimages.edit

Flare 文生图

Sunburst 图像编辑

先准备本地 source.png,再运行:
两种模型均接受文本与图像输入;示例按各自侧重点选型,不表示 Flare 不能编辑或 Sunburst 不能生成。
以上是依据上线通知和官方接口编写的接入示例,本轮参数实测针对下文的 VIP 文生图线路,未对本节官转线路执行出图验收。OpenAI 为两个官转 2.5 模型列出的 quality 包括 lowmediumhighxhighmaxauto;新增档位、尺寸边界及其他可选字段需在目标令牌复核。官方 Responses 图像工具说明不能单独证明老张API同一路线支持 Responses。

保存图片并验收

成功的 Images API 响应应包含图像结果。对于 data[0].b64_json,以下脚本将文生图结果保存为图片;编辑请求改读 edit.json
打开 output.png,检查图片能否正常显示、实际尺寸是否符合请求;编辑时再检查要求保留的内容和指定改动。若线路返回 data[0].url,下载并打开该 URL 对应图片。随后在调用日志核对模型、分组、usage 和实际扣费。HTTP 200 或模型出现在列表中不能代替图片验收。 认证或模型权限错误先检查 Key、分组和模型 ID;参数错误按返回信息调整请求。若返回对象没有图片,保留脱敏错误和日志时间,按Images API 参考检查,联系支持时不要发送完整 Key。

GPT Image 2.5 官转计费

两种 2.5 模型与 gpt-image-2 官转的 token 单价相同,按文本输入、图片输入和图片输出的实际用量计费。它们不采用旧按次线路的固定每次价格。 上表为 OpenAI 官方 token 单价。老张API实际结算需结合当前模型价格与令牌分组;企业报价联系支持团队确认。同价不等于单张图片总价相同,模型、尺寸、质量和参考图会影响 token 用量,应以代表性请求的 usage 估算。

GPT Image 2.5 VIP 按次线路

新增 gpt-image-2.5-flare-vipgpt-image-2.5-sunburst-vip,均为 $0.03/次,接入方式和计费方式与 gpt-image-2-vip 一致。使用 Default 分组的按次令牌,确认令牌已开放目标模型。

VIP 文生图的 size 与 quality

两个 VIP 模型的文生图请求均可使用 sizequalityquality 使用 lowmediumhighVIP 当前不支持 xhighmax,传入这两个值会返回 HTTP 400。不需要指定尺寸或质量时,省略相应字段即可。 2026 年 9 月 9 日文生图实测: 下表的“已验证”均已解码返回 PNG 并核对实际宽高,不只检查 HTTP 状态。测试使用 /v1/images/generations,包括 curl、HTTP 请求和 OpenAI Python SDK 2.24.0。 “待验证”表示本轮尚未取得对应规格的有效图片,不表示该规格不支持。尺寸验证记录来自本轮代表性请求,并不代表每个尺寸与每个质量档位的所有组合均已测试。
需要两款 VIP 共用一份入门请求时,可以先用 size="2048x2048"quality="medium",两款模型均已在该组合返回实际 2K 方图。quality 会影响返回的生成用量,VIP 的计费方式仍为按次;实际单价与扣费以控制台为准。
尺寸边界: 请传入规范尺寸,并核对响应 size 和实际图片像素。本轮 Sunburst 将 1023x1024 调整为 1024x1024 后出图,不能依赖非法尺寸一定报错,也不要用非标准尺寸来要求精确像素。

VIP 文生图示例

已有 gpt-image-2-vip 集成时,保留 base URL、鉴权、接口和结果处理,将 model 替换为上表的完整 ID。以下使用已验证的 2K、medium 组合:

VIP 图像编辑示例

编辑接入形式沿用 gpt-image-2-vip 的 multipart 请求,先准备本地 source.png。本轮参数验收表只覆盖文生图;编辑接口的尺寸、质量和最终编辑效果尚未完成独立实体验证。
两个 VIP 模型使用同一种接入方式,可按需替换或让用户自选。上面的图片保存与验收步骤也适用;实际价格和扣费以控制台及调用日志为准。
VIP 模型是老张API提供的按次线路,必须保留 -vip 后缀;不带 -vip 的 Flare / Sunburst 是官转按 tokens 线路。VIP 的文生图尺寸与质量请按上面的实测范围使用;官转快照 ID 和 xhigh / max 档位不适用于当前 VIP 接入。

Default 分组:gpt-image-2-web 已更新至网页版 2.5

Default 分组的网页版线路继续使用 gpt-image-2-web,服务上线通知确认它已对应 GPT 网页版最新的 2.5。已有这一路线的集成保留该模型 ID 即可,无需为了网页版更新改成 Flare 或 Sunburst。 gpt-image-2-web 是老张API的网页版线路模型名;它与 Flare / Sunburst 是不同接入线路,不应把网页版 2.5 等同于某个官转快照。当前公开价格目录列为 $0.03/次,没有改为官转 token 计费;实际结算和参数范围以该线路控制台配置为准。

相关文档

来源与状态核对