Skip to main content
老张API的 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:
  1. 创建 Sora2Official 或 GPTImage2 Sora2 Enterprise 分组的按量计费令牌;需要只走 OpenAI 官方密钥时,选择 GPTImage2 Sora2 Enterprise。
  2. 保留 model="gpt-image-2",把 base URL 改为 https://api.laozhang.ai/v1。
  3. API Key 换成老张API令牌。

官转传 response_format 报错怎么办?

删掉 response_format 和 input_fidelity 这两个字段。按 OpenAI 的规则:
  • GPT Image 模型始终返回 Base64 图片,不支持 response_format;
  • gpt-image-2 会自动以高保真处理每张输入图片,不允许修改 input_fidelity。
从 DALL·E 或更早的 GPT Image 模型迁移过来的代码常带着这两个字段。 需要图片链接时,把 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 及其常见问题。

相关文档与来源