gpt-image-2 按次还是按 token 计费,由令牌分组决定,只改请求里的 model 不会改变计费方式。这里的说明面向已有的 GPT Image 2 集成。
新接入请优先使用 GPT Image 2.5。已有集成一般只需换
model,并确认令牌可以调用新模型:gpt-image-2-vip换成 2.5 的-vip模型;- 官转集成换成
gpt-image-2.5-flare或gpt-image-2.5-sunburst。
令牌分组与计费
gpt-image-2 和 gpt-image-2-vip 通过 OpenAI 兼容的 Images 接口调用:生成用 POST /v1/images/generations,编辑用 POST /v1/images/edits。
官方 API 转发(官转)指请求经老张API转发到官方 API 服务,并按官方的 token 口径计费。创建令牌时选择的分组和计费模式决定了线路:
价格来自 2026 年 9 月 24 日公开价格配置(见模型与价格总表)。官转按量计费,
Sora2Official 分组与 OpenAI 官方同价,每 1M tokens 单价为:
- 文本输入 $5,缓存文本输入 $1.25;
- 图像输入 $8,缓存图像输入 $2;
- 图像输出 $30。
GPTImage2 Sora2 Enterprise 分组为官方价加 20%(分组倍率 1.2)。实际扣费以调用日志为准,企业报价联系支持团队确认。
两个官转分组的区别:
Sora2Official:官转分组,与 OpenAI 官方同价,上游为 Azure OpenAI 与 OpenAI 官方密钥混合。GPTImage2 Sora2 Enterprise:只使用 OpenAI 官方密钥,价格为官方价加 20%,适合对稳定性和官方参数一致性要求更高的生产调用。
model。发现扣费方式与预期不符时,先检查这个 Key 在控制台中的分组和计费模式。
所有分组都不限制并发、不限速,429 来自上游容量,见并发与 429;上游返回非 200 的请求不扣费。
参数支持
default 分组的 gpt-image-2
按次线路,不支持size 和 quality。需要按次计费并控制尺寸时,改用 gpt-image-2-vip。
gpt-image-2-vip
size:常用1024x1024、2048x2048、3840x2160。- 竖版 4K 可尝试
size为2160x3840,以返回图片的实际尺寸为准。 quality:low、medium、high。- 通常返回
data[0].b64_json,偶尔返回图片链接。只要 Base64 时传response_format: "b64_json";传url返回有有效期的链接。 - 编辑时可以重复传
image[],一次提交多张参考图。 - 不支持
mask:传了也不能可靠地只改指定区域。 - 不支持透明背景,传
background="transparent"会返回 400。需要透明底 PNG 时改用 GPT Image 2.5 的-vip模型。
官转分组的 gpt-image-2
按 OpenAI 官方参数编写请求,只替换 base URL 和 API Key。常用取值:
其他字段按官方文档编写,正式使用前先在目标分组用少量请求确认。
quality 会明显影响生成耗时和输出 token 量。批量预览可先用 low 或 medium,定稿再用 high。
配置密钥与依赖
default 分组的按次计费令牌,官转示例使用 Sora2Official 或 GPTImage2 Sora2 Enterprise 分组的按量计费令牌。pillow 供后面的保存脚本识别图片格式。
生成图片
以下示例都把响应写入generation.json。按你的令牌分组任选一个运行,再用保存脚本取出图片。
default 分组:gpt-image-2
不传size 或 quality:
default 分组:gpt-image-2-vip
需要按次计费并控制尺寸时,在请求体中传入size 和 quality:
官转分组:gpt-image-2
使用Sora2Official 或 GPTImage2 Sora2 Enterprise 分组的令牌,参数按官方写法:
编辑图片
编辑使用multipart/form-data 上传本地图片:
- 先把要编辑的图片保存为当前目录下的
source.png; - 使用
-F时由 cURL 自动设置Content-Type,不要再加application/json; - 以下示例都把响应写入
edit.json。
default 分组:gpt-image-2
default 分组:gpt-image-2-vip
官转分组:gpt-image-2
保存返回的图片
响应的data[] 中,每一项是下面两种之一:
b64_json:Base64 图片内容,可能带data:image/png;base64,这类前缀,也可能缺少末尾的=。url:图片下载地址,会过期,收到响应后要尽快下载。
save_images.py,它会处理上述情况,并按实际格式命名文件:
generated-1.png,并打印实际尺寸。打开图片检查内容,再到控制台调用日志核对模型、分组和扣费。
常见问题
同一个 gpt-image-2 为何计费不同?
因为线路由令牌分组决定,参数范围也随之不同:default分组:按次计费,不支持尺寸和质量参数。Sora2Official与GPTImage2 Sora2 Enterprise分组:走官转,按 token 计费,参数按官方写法。
不带 -vip 的按次线路能传 size 吗?
不能,default 分组的 gpt-image-2 不支持尺寸参数。需要按次计费并控制尺寸时,使用 gpt-image-2-vip;需要官方参数写法时,使用官转分组的 gpt-image-2。
gpt-image-2-vip 能输出 4K 吗?
可以。横版 4K 使用3840x2160;竖版 4K 可以尝试 2160x3840,先用正式提示词测试,并以返回图片的实际尺寸为准。
已有 OpenAI 官方代码,怎样迁移到官转?
保留官方请求体,只换令牌和 base URL:- 创建
Sora2Official或GPTImage2 Sora2 Enterprise分组的按量计费令牌;需要只走 OpenAI 官方密钥时,选择GPTImage2 Sora2 Enterprise。 - 保留
model="gpt-image-2",把 base URL 改为https://api.laozhang.ai/v1。 - API Key 换成老张API令牌。
官转传 response_format 报错怎么办?
删掉response_format 和 input_fidelity 这两个字段。按 OpenAI 的规则:
- GPT Image 模型始终返回 Base64 图片,不支持
response_format; gpt-image-2会自动以高保真处理每张输入图片,不允许修改input_fidelity。
b64_json 解码后上传到自己的存储,不要依赖接口返回 URL。
官转编辑图片为什么比文生图贵?
因为参考图也按 token 计费。gpt-image-2 会自动以高保真处理每张输入图片,参考图按图片输入 token 计费,所以带参考图的编辑请求输入 token 可能明显多于纯文生图,参考图越多,输入费用越高。输出部分仍由尺寸和质量决定。
预算时用几次代表性编辑请求的 usage 估算,实际扣费以调用日志为准。按次线路不受参考图影响,仍按上表的单次价格扣费。
b64_json 解码失败怎么办?
常见原因是返回值带有data:image/png;base64, 前缀或末尾缺少 =,保存脚本会先处理这两种情况再解码;仍然失败时,检查响应是否其实是错误 JSON。
已有集成需要迁移到 GPT Image 2.5 吗?
不必立即迁移,需要 2.5 的效果时再按页首提示替换模型 ID,接口和结果处理保持不变。官转换成 2.5 后,同名quality 档位的 token 用量和耗时可能变化,上线前先用正式提示词重新测试。完整说明见 GPT Image 2.5 API 及其常见问题。
相关文档与来源
- GPT Image 2.5 API:新接入推荐的模型与线路
- Images API 参考:通用请求、响应与错误处理
- 图像生成 API 选型与价格:与其他图像模型对比
- OpenAI GPT Image 2与 OpenAI 图像生成指南:官方模型说明与参数
- OpenAI Images API 参考:
response_format等官方字段说明 - 控制台模型价格:当前单价与可用分组