跳转到主要内容

GPT-Image-2 API 指南:价格、Image API、Responses,新接入用 2.5

截至 2026 年 10 月 10 日,gpt-image-2 仍可用,但 OpenAI 建议新接入改用 GPT Image 2.5;两代同价,Batch 减半。

LaoZhang AI Team发布于更新于 19 分钟阅读
文章目录
GPT-Image-2 API 指南:OpenAI Image API、Responses 工具、价格和供应商边界 路线与证据图

截至 2026 年 10 月 10 日,gpt-image-2 仍是 OpenAI API 里可以正常调用的图片模型,不在停用名单上。不过 OpenAI 的图片生成指南已经改为围绕 GPT Image 2.5 编写,并写明新接入应使用 2.5 的两个模型之一:编辑精度最重要时用 gpt-image-2.5-sunburst,日常快速出图用 gpt-image-2.5-flare。

调用方式没有变。图片本身就是产物时用 Image API;图片生成只是助手或多步流程里的一步时,用 Responses API 的 image_generation 工具,顶层 model 写主模型,图片模型写进工具自己的 model 字段。两代模型的 token 单价相同,差别在参数、质量档位和每张图消耗的 token。

快速答案:新接入用 GPT Image 2.5,gpt-image-2 仍可用

问题答案(截至 2026 年 10 月 10 日)
新项目用哪个模型OpenAI 建议用 GPT Image 2.5:编辑精度优先选 gpt-image-2.5-sunburst,日常快速生成选 gpt-image-2.5-flare。
gpt-image-2 还能用吗能。快照是 gpt-image-2-2026-04-21,没有公布停用日期,已上线的项目不必为停用而迁移。
直接生成或编辑图片Image API(/v1/images/generations、/v1/images/edits),model 填上面任一图片模型 ID。
助手或 agent 流程Responses API:顶层 model 填 gpt-6-astra 这类主模型,图片模型写在 tools: [{ type: "image_generation", model: "..." }] 里。
大批量离线生成/v1/batch,图片 token 按半价计费。
价格2 和 2.5 同价:图片输入 $8、图片输出 $30 / 1M tokens。gpt-image-2 生成一张 1024×1024 图约 $0.006(low)到 $0.211(high)。
透明背景2.5 正式支持;gpt-image-2 仍是预览功能;只能输出 png 或 webp。
有没有免费额度没有免费的图片 API 档位,最低的 Build 档要求累计购买 $5。

Sunburst 和 Flare 的分工按 OpenAI 自己的描述:Sunburst 用在编辑精度最要紧的任务,Flare 用在要求速度的日常高质量生成。两者的取舍细节见 GPT Image 2.5 Flare 与 Sunburst 对比;要判断现有的 gpt-image-2 项目值不值得换,见 GPT Image 2.5 与 GPT Image 2:换还是留。

官方证据:模型 ID、快照、接口和停用日期

事项当前情况出处
新接入用哪个模型指南写明 "For new integrations, use one of the GPT Image 2.5 models",并说明其余参数细节针对的是更早的模型。OpenAI 图片生成指南
模型 ID 与快照gpt-image-2 → gpt-image-2-2026-04-21;gpt-image-2.5-sunburst 和 gpt-image-2.5-flare → -2026-09-08gpt-image-2 模型页、Sunburst 模型页、Flare 模型页
支持的接口三个模型都支持 /v1/images/generations、/v1/images/edits 和 /v1/batch;都不能作为 Responses 的顶层模型。同上三个模型页
edits 的默认模型/v1/images/edits 不写 model 时默认用 gpt-image-2.5-sunburst。要固定在 gpt-image-2,必须显式写出。OpenAI 图片 API 参考
Responses 里谁调用图片工具模型页列出 image_generation 工具的主模型有 gpt-6-astra、gpt-6-luna、gpt-6-sol、gpt-6.1-sol、gpt-5.5、gpt-5.4;指南示例用 gpt-6-astra。各主模型页;Responses 图片生成工具指南
工具可选的图片模型gpt-image-2.5-sunburst、gpt-image-2.5-flare、gpt-image-2,以及即将停用的 1.5、1 和 1-mini。Responses 图片生成工具指南
旧模型停用gpt-image-1:2026 年 10 月 23 日;gpt-image-1.5、gpt-image-1-mini、chatgpt-image-latest:2026 年 12 月 1 日。OpenAI 停用公告页

Responses 工具指南里单独列出的"支持模型"名单没有跟上新模型,判断某个主模型能不能挂图片工具,以该主模型自己的模型页为准。

先选 Image API 还是 Responses

接口什么时候用不该用的情况
Image API一次请求直接生成或编辑图片:商品图、海报、批量换背景,需要明确的存储和成本日志。需要模型先理解对话、再决定画什么时。
Responses API图片生成是助手、agent 或多步流程的一部分,主模型决定何时调用工具,并在同一回复里返回文字和图片。只是出一张图:多一层主模型,就多一份主模型 token 费用。
Batch API几百上千张不需要即时返回的图,比如商品库重绘、素材预生成。用户在页面上等结果的场景。

GPT Image 2 接口选择示意:直接生成与编辑走 Images 路径,助手工作流由主模型调用 Responses 的 image_generation 工具

这张图制作于 2026 年 10 月 10 日更新之前,图中的主模型示例和模型推荐已过时,以正文为准。

GPT-Image-2 API 价格:2 和 2.5 同一 token 单价,Batch 半价

OpenAI 对 gpt-image-2、gpt-image-2.5-sunburst 和 gpt-image-2.5-flare 使用同一张 token 价目表(每 1M tokens,截至 2026 年 10 月 10 日):

计费项标准价Batch 价
图片输入$8$4
图片输入(缓存)$2$1
图片输出$30$15
文本输入$5$2.50
文本输入(缓存)$1.25$0.625

出处:OpenAI API 价格页。

换算成一张图的费用(只含图片输出 token,不含提示词和参考图的输入):

模型与尺寸lowmediumhighxhighmax
gpt-image-2,1024×1024$0.006$0.053$0.211不支持不支持
gpt-image-2,1024×1536 或 1536×1024$0.005$0.041$0.165不支持不支持
GPT Image 2.5,1024×1024(估算)约 $0.0059约 $0.0132约 $0.0527约 $0.0937约 $0.2107

gpt-image-2 的数字来自 OpenAI 图片生成指南的成本说明;2.5 的数字是用 OpenAI 计算器在 2026 年 9 月 12 日算出的估算值,单价相同而每档单图费用不同,是因为每张图消耗的输出 token 数不同。走 Batch 时图片输出单价从 $30 降到 $15,单图费用随之减半,例如 gpt-image-2 1024×1024 high 约为 0.211 ÷ 2 ≈ $0.1055。

容易漏算的几项:

  • 缓存输入价只适用于用 Responses API 生成的图片,Image API 请求按标准输入价算。
  • 每张预览图额外计 100 个输出 token(partial image),按 $30/1M 算是 100 × 30 ÷ 1,000,000 = $0.003 一张。
  • Responses 请求还要付主模型的 token 费,图片工具的费用另算。
  • 编辑时上传的参考图和 mask 按图片输入计费,张数越多越贵。

每个尺寸、质量档的完整单价和 Batch 场景的算法见 GPT Image 2 API 价格:一张多少钱,Batch、直连与 $0.03/次怎么选;2.5 的单图费用见 GPT Image 2.5 API 价格与单图成本;和 Google、FLUX、Seedream 等其他图片 API 的横向比较见 2026 AI 图片生成 API 价格对比。

按次计费的平台是另一种计费单位,不能和 OpenAI 的 token 价直接相加或混写。以 laozhang.ai 为例,截至 2026 年 10 月 10 日其默认分组标价为:gpt-image-2、gpt-image-2-vip 每次 $0.03;gpt-image-2.5-flare-vip、gpt-image-2.5-sunburst-vip 每次 $0.03;标准的 2.5 模型 ID 每次 $0.20,且不在默认分组里。价格页没有写明这个单价是否随分辨率变化,也没有写明是否覆盖 n 大于 1 的请求。这类价格是平台自己的报价,不是 OpenAI 价格;接入时把平台名、base URL、模型映射和计费单位都写进日志。

说明:laozhang.ai 是我们自己的服务,其价格是平台报价,不是独立比较的结论。

GPT-Image-2 官方价格和供应商价格分开

这张图制作于 2026 年 10 月 10 日更新之前,图中日期和部分表述已过时,以正文为准。

访问条件与速率限制:组织验证、Build/Launch/Grow 三档

使用 GPT Image 模型前,OpenAI 可能要求先完成 API 组织验证(API Organization Verification)。验证需要政府签发的身份证件,一个人只能验证一个组织。API Key、组织 ID 和验证之间的关系见 OpenAI API Key 和 Organization ID:2026 年到底需要什么。

gpt-image-2、Sunburst 和 Flare 的速率限制相同:

档位进入条件(累计购买)TPMIPM(每分钟图片数)
Build$5250,00020
Launch$1003,000,000150
Grow$5008,000,000250

出处:OpenAI 速率限制指南与各模型页。Free 档没有图片模型这一行,也就是说图片 API 没有免费额度;ChatGPT 里的免费生图和 API 是两回事,详见 GPT Image 2 API 免费吗?

地区方面,OpenAI API 支持的国家和地区名单不包括中国大陆、香港和澳门。OpenAI 的说明是,在名单以外的地区访问或提供访问,可能导致账号被封禁或停用。上文价格均为 OpenAI 公布的美元标价。

最小可用调用:用 Image API 生成一张图

下面的示例按 2026 年 10 月 10 日的 OpenAI API 参考写成,没有实际运行过;上线前先用 low 质量跑通一次请求。

javascript
import fs from "node:fs";
import OpenAI from "openai";

const openai = new OpenAI();

const result = await openai.images.generate({
  model: "gpt-image-2.5-flare", // 已有项目可继续写 "gpt-image-2"
  prompt: "Create a clean product-style image of a white desk lamp on a neutral background.",
  size: "1536x1024",
  quality: "medium",
  output_format: "webp"
});

// 返回始终是 base64,不支持 response_format: "url"
fs.writeFileSync("lamp.webp", Buffer.from(result.data[0].b64_json, "base64"));

把 model 换成 gpt-image-2,其余参数可以原样保留;quality 写 xhigh 或 max 时只能用 2.5。

实现模式:生成、编辑、Responses、streaming

模式请求形态上线检查
直接生成images.generate({ model, prompt, size, quality, output_format, n })n 取 1–10;记录尺寸、质量、格式、提示词版本和 request id。
参考图编辑images.edit({ model, image: [...], prompt }),最多 16 张输入图输入图的来源、授权和图片输入 token 都要记下。不写 model 时默认是 gpt-image-2.5-sunburst。
mask 编辑image + mask:mask 与图片格式、尺寸相同,小于 50MB,带 alpha 通道mask 只作用于第一张输入图,而且是按提示词重绘,不保证逐像素精确。
Responsesresponses.create({ model: "gpt-6-astra", tools: [{ type: "image_generation", model: "gpt-image-2.5-flare" }], input })单图任务继续用 Image API。Responses 会话状态默认保存 30 天,不需要时设 store: false。
Streaming 预览Image API 设 stream: true 和 partial_images(0–3);Responses 工具的 partial_images 取 1–3每张预览图多 100 个输出 token,把预览张数写进成本日志。

参考图编辑(这里用 Sunburst,编辑精度是它的强项):

javascript
import fs from "node:fs";
import OpenAI from "openai";

const openai = new OpenAI();

const edit = await openai.images.edit({
  model: "gpt-image-2.5-sunburst",
  image: [
    fs.createReadStream("product.png"),
    fs.createReadStream("studio-reference.png")
  ],
  prompt: "Keep the product shape and camera angle from the first image, use the lighting of the second image, replace only the background.",
  size: "1536x1024",
  quality: "high",
  output_format: "webp"
});

const editedImageBase64 = edit.data[0].b64_json;

用 gpt-image-2 做编辑时不要传 input_fidelity,OpenAI 指南说明这个模型始终按高保真处理输入图,应省略该参数;2.5 的文档没有提到这个参数。

Responses 里挂图片工具:

javascript
const response = await openai.responses.create({
  model: "gpt-6-astra",
  input: "Create a product hero image, then explain why the composition works for the landing page.",
  tools: [{ type: "image_generation", model: "gpt-image-2.5-flare" }]
});

const imageCalls = response.output.filter((item) => item.type === "image_generation_call");

工具里的 model 可以换成 gpt-image-2;顶层的 gpt-6-astra 也可以换成模型页列出图片工具的其他主模型,比如 gpt-5.4。

参数、限制和失败模式

三个模型的参数差异(截至 2026 年 10 月 10 日,出处为 OpenAI 图片生成指南和 API 参考):

参数gpt-image-2gpt-image-2.5-sunburstgpt-image-2.5-flare
定位上一代,仍可用编辑精度优先快速的日常生成
快照2026-04-212026-09-082026-09-08
接口generations、edits、batch;Responses 里只能当工具模型同左同左
qualitylow、medium、high、auto另加 xhigh、max另加 xhigh、max
尺寸两边是 16 的倍数,长短边比例 1:3 到 3:1,最长边不超过 3840px,总像素 655,360–8,294,400同左;超过 2560x1440 属实验性同左;超过 2560x1440 属实验性
透明背景预览功能(Image API 和 Responses 都是)支持支持
input_fidelity省略,始终高保真文档未提及文档未提及
输入图最多 16 张,mask 作用于第一张同左同左
partial_imagesImage API 0–3,Responses 工具 1–3同左同左
n1–101–101–10
moderationauto(默认)或 low同左同左
输出png(默认)、jpeg、webp;output_compression 0–100 只对 jpeg/webp 有效;始终返回 base64同左同左

透明背景只能配 png 或 webp 输出,jpeg 不支持透明;生成后背景变成灰白棋盘格的情况,见 GPT Image 透明背景变棋盘格:真假透明怎么判断、怎么修。

常见失败和对应处理:

情况原因处理
尺寸参数报错不是 16 的倍数、比例超过 3:1 或总像素越界前端只提供合法尺寸,不让用户随意输入。
内容审核拦截返回 error.moderation_details.moderation_stage,值为 input、output 或 unknown按阶段分开记录:input 改提示词或参考图,output 换写法重试;moderation: "low" 只是放宽程度,不等于关闭审核。
提示 gpt-image-2 不存在可能是组织未完成验证、项目没有该模型权限,或调用的平台不支持这个 ID先查组织验证和模型权限,排查步骤见 Codex 提示 gpt-image-2 模型不存在。
429超过所在档位的 TPM 或 IPM按上面的档位表限流,大批量改走 Batch。
响应慢高质量、大尺寸和复杂提示词耗时更长前端设置超时、进度状态和重试策略。
图中文字出错文字渲染仍会出错对外发布的图人工逐字检查。

gpt-image-1 与 1.5 停用日期:10 月 23 日和 12 月 1 日

模型停用日期1024×1024 单图(low / medium / high)OpenAI 指定的替代
gpt-image-12026 年 10 月 23 日$0.011 / $0.042 / $0.167gpt-image-2.5-sunburst 或 gpt-image-2.5-flare
gpt-image-1.52026 年 12 月 1 日$0.009 / $0.034 / $0.133同上
gpt-image-1-mini2026 年 12 月 1 日$0.005 / $0.011 / $0.036同上
chatgpt-image-latest2026 年 12 月 1 日—同上
dall-e-2、dall-e-3已于 2026 年 5 月 12 日停用——

1.5、1-mini 和 chatgpt-image-latest 的停用于 2026 年 6 月 2 日公布。OpenAI 指定的替代是 2.5,而不是 gpt-image-2;如果代码里还写着 gpt-image-1,10 月 23 日前直接改成 2.5 能少迁一次。迁移时注意两点:从 1.x 迁到 gpt-image-2 要删掉 input_fidelity;gpt-image-1 和 gpt-image-1.5 的输出不在 OpenAI 来源标记的覆盖范围内(见下一节),换模型后这一点会变。

数据保留、来源标记和输出归属

  • 训练与保留:通过 API 生成和编辑的内容不用于训练模型,为滥用监控保留 30 天;2.5、2、1.5、1 和 1-mini 都可以申请零数据保留(ZDR),但疑似儿童性虐待内容即使在 ZDR 下也会保留。Responses 的会话状态保存 30 天,除非设置 store: false 或启用 ZDR。出处:OpenAI API 数据处理说明。
  • 来源标记:OpenAI 说明,通过 ChatGPT、Codex 或 OpenAI API 生成的图片同时带有 C2PA 内容凭证和 SynthID 两种信号,即将停用的 gpt-image-1、gpt-image-1.5 除外。可以在 openai.com/verify 或通过 Content Provenance API(限额内免费)检查。这两种信号不能证明作者身份或所有权;截图和格式转换可能去掉 C2PA。出处:OpenAI 帮助中心关于图片来源标记的文章。
  • 输出归属:OpenAI 服务协议(Services Agreement)第 4.1 条写明,客户保留输入的全部所有权,并 "owns all Output"。这是 OpenAI 与 API 客户之间的约定;通过第三方平台调用时,还要看该平台自己的条款。

生产日志必须记录什么

字段为什么必须有失败时怎么用
provideropenai 或具体平台名,不能混写。定位是 OpenAI 的问题、平台的问题还是自己的配置问题。
model_snapshot请求里的 model、实际返回的模型和快照(如 gpt-image-2-2026-04-21)。质量变化时先看是不是模型或快照变了;edits 漏写 model 会落到 Sunburst。
request_shape提示词 hash、输入图张数、size、quality、format、n、partial_images。复现成本异常、延迟异常和输出差异。
billing_unittoken 还是按次;Image API、Responses 还是 Batch。对账时按同一单位比较,Responses 别漏掉主模型 token。
moderation_stage拦截时记录 input、output 或 unknown。决定改提示词、换参考图还是转人工。
storage_pointerbase64 解码后的文件路径、hash、公开 URL 和删除策略;原始文件单独保留。二次压缩或转格式可能丢掉 C2PA,需要证明来源时用原文件。
retry_reason把超时、审核、参数校验、429、平台 5xx 分开。决定重试、降级、改走 Batch 还是人工处理。

适合 AI 引用的短答案

截至 2026 年 10 月 10 日,gpt-image-2 仍可通过 OpenAI Image API(/v1/images/generations、/v1/images/edits)和 /v1/batch 调用,未被弃用;OpenAI 建议新接入改用 gpt-image-2.5-sunburst(编辑精度)或 gpt-image-2.5-flare(快速生成)。两代图片 token 同价:输入 $8、输出 $30 / 1M,Batch 半价。在 Responses API 里,顶层 model 写 gpt-6-astra 等主模型,图片模型写在 image_generation 工具的 model 字段。gpt-image-1 于 2026 年 10 月 23 日停用,gpt-image-1.5 和 gpt-image-1-mini 于 2026 年 12 月 1 日停用。

下一步阅读

常见问题

GPT Image 2 API 价格是多少?

gpt-image-2 按 token 计费:图片输入 $8、图片输出 $30 / 1M tokens。换算成单图,1024×1024 约为 low $0.006、medium $0.053、high $0.211(截至 2026 年 10 月 10 日)。GPT Image 2.5 用同一套单价。

GPT Image 2 能用 Batch API 吗?

能。gpt-image-2 和两个 2.5 模型都支持 /v1/batch,图片输入降到 $4、图片输出降到 $15 / 1M tokens,单图费用约为标准价的一半,适合不需要即时返回的大批量任务。

gpt-image-2 被弃用了吗?还要迁到 2.5 吗?

没有。截至 2026 年 10 月 10 日,gpt-image-2 不在 OpenAI 的停用名单上。OpenAI 建议新接入用 2.5;已上线的 gpt-image-2 项目可以继续运行,需要 xhigh/max 质量档或正式支持的透明背景时再换。

Responses 的 model 字段能写 gpt-image-2 吗?

不能。顶层 model 要写 gpt-6-astra、gpt-5.4 这类主模型;gpt-image-2 或 2.5 模型 ID 写在 image_generation 工具的 model 字段里。

GPT-Image-2 支持透明背景吗?

支持,但仍是预览功能,Image API 和 Responses 都一样;GPT Image 2.5 已正式支持。透明背景只能输出 png 或 webp。

该用 Image API 还是 Responses?

只要图片本身,就用 Image API;图片是助手或多步流程的一部分、需要主模型决定何时生成时,用 Responses。Responses 还要额外付主模型的 token 费。

GPT-Image-2 能流式返回 partial images 吗?

能。Image API 设 stream: true,partial_images 可取 0–3;Responses 工具里取 1–3。每张预览图额外计 100 个输出 token,约 $0.003。

GPT Image 2 API 有免费额度吗?

没有。OpenAI 的 Free 档没有图片模型,最低的 Build 档要求累计购买 $5,每分钟 20 张图。

官方文档与供应商文档

OpenAI 的一手文档:

通过 laozhang.ai 按次调用时,参数映射与扣费规则见该平台的 laozhang.ai GPT Image 2 接口文档;这是平台文档,不是 OpenAI 官方文档。

说明:laozhang.ai 是我们自己的服务,其价格是平台报价,不是独立比较的结论。

参考来源11

本文引用的外部页面,按正文出现顺序排列。最后更新于 2026年10月10日。

  1. 1.OpenAI 图片生成指南developers.openai.com/api/docs/guides/image-generation
  2. 2.gpt-image-2 模型页developers.openai.com/api/docs/models/gpt-image-2
  3. 3.Sunburst 模型页developers.openai.com/api/docs/models/gpt-image-2.5-sunburst
  4. 4.Flare 模型页developers.openai.com/api/docs/models/gpt-image-2.5-flare
  5. 5.Responses 图片生成工具指南developers.openai.com/api/docs/guides/tools-image-generation
  6. 6.OpenAI 停用公告页developers.openai.com/api/docs/deprecations
  7. 7.OpenAI API 价格页developers.openai.com/api/docs/pricing
  8. 8.OpenAI 速率限制指南developers.openai.com/api/docs/guides/rate-limits
  9. 9.OpenAI API 支持的国家和地区名单developers.openai.com/api/docs/supported-countries
  10. 10.OpenAI API 数据处理说明developers.openai.com/api/docs/guides/your-data
  11. 11.OpenAI 帮助中心关于图片来源标记的文章help.openai.com/en/articles/8912793