GPT Image 2 完整指南
截至 2026-10-20，GPT Image 2（gpt-image-2）是 OpenAI 于 2026 年 4 月 21 日发布的图像生成与编辑模型，支持灵活尺寸与高保真图像输入；官方按图像 token 计费，图像输入 $8 / 缓存输入 $2 / 图像输出 $30 每 100 万 token，Batch 处理为 $4 / $1 / $15。QCode 按输出图片张数计费，每张 $0.30（generations 与 edits 同价）；这与官方的图像 token 计价是两套口径。
GPT Image 2 是什么
GPT Image 2 是 OpenAI 于 2026 年 4 月 21 日发布的图像生成与编辑模型，模型 ID 为 gpt-image-2，默认快照 gpt-image-2-2026-04-21；官方称它支持灵活的图像尺寸与高保真图像输入，通过 Images API 的 generations 与 edits 端点调用。DALL·E 2 与 DALL·E 3 已于 2026 年 5 月 12 日从 API 移除，官方推荐改用 gpt-image-2 等模型。截至 2026-10-20，OpenAI 又在 2026 年 9 月 8 日发布了后续的 GPT Image 2.5 Sunburst 与 Flare，官方指南建议新接入优先选用 2.5 系列。
关键能力
支持文生图、图生图、局部重绘、文本渲染、多分辨率（1024×1024 / 1024×1536 / 1536×1024，官方 API 还支持到 4K）与多画质（low / medium / high / auto）。OpenAI 官方按图像 token 计费，尺寸、画质与输入图数量都会改变 token 数，从而影响总价。
计费方式：每张 $0.30
GPT Image 2 按输出图片张数计费，generations 与 edits 同价：每张输出图片 $0.30，一次生成 n 张即 n × $0.30。size、quality、输入图片张数、mask、prompt 长度都不影响价格。失败的请求（4xx 含内容审核拒绝、5xx、超时、客户端断开）一律不计费。自 2026-10-06 起，计费由按 token 计费改为每张 $0.30。
- 每张输出图片 — $0.30
- size / quality / 输入图片张数 / mask / prompt 长度都不影响价格
- 失败的请求（4xx / 5xx / 超时 / 客户端断开）一律不计费
价格与 size / quality 等参数无关，也不论输入图片数量；只按返回的输出图片张数计。
通过 QCode 接入
GPT Image 2 已列在 /models 目录中；要判断当前能不能调用，请看 /models 目录与状态页，而不是任何静态页面的文字。计费按输出图片张数计，每张 $0.30，generations 与 edits 同价。同一 QCode 套餐配额可用于 Claude Code、OpenAI Codex 等多个 CLI 工具。
generations 与 edits 同价；一次生成 n 张即 n × $0.30。
4xx（含内容审核拒绝）/ 5xx / 超时 / 客户端断开，一律不收费。
API 接入示例
通过 OpenAI 兼容 API 调用,只需把 BASE_URL 切换到 QCode 端点,API Key 用 QCode Key,其他与官方 SDK 一致。
from openai import OpenAI
import base64
# 注意：图像生成走专用端点 /qcode-img/v1（与文本 /openai/v1 区分）
client = OpenAI(
api_key="$QCODE_KEY",
base_url="https://api.qcode.cc/qcode-img/v1",
timeout=180.0, # OpenAI SDK default is short, recommend 180s
)
response = client.images.generate(
model="gpt-image-2",
prompt="A serene Japanese garden with a koi pond",
size="1024x1024",
quality="medium",
)
img = base64.b64decode(response.data[0].b64_json) # 只返回 b64_json；把 response_format 设成 url 会被 400 拒绝
open("out.png", "wb").write(img)
# 完整端点路径: POST https://api.qcode.cc/qcode-img/v1/images/generations适用场景
营销素材生成、社交媒体海报、电商商品图、图书插图、概念设计草稿、演示文稿配图、UI mockup、原型设计图。需要局部修改时可用 edits 端点配合 mask，也可以用多张参考图合成新图。
从 DALL·E 3 迁移，以及与 Midjourney / Stable Diffusion 对比
DALL·E 3:OpenAI 官方 changelog 记载 dall-e-2 与 dall-e-3 已于 2026 年 5 月 12 日从 API 移除，官方当时建议改用 gpt-image-2 等模型，仍在调用 DALL·E 3 的集成需要迁移。vs Midjourney:API-first 设计适合程序化集成,Midjourney 偏 Discord 创作者工作流。vs Stable Diffusion:闭源但效果与可控性更稳定,无需自部署 GPU 资源。截至 2026-10-15，OpenAI 官方指南建议新接入优先考虑 GPT Image 2.5 系列，可按画质、尺寸与编辑需求在 gpt-image-2 与 2.5 系列之间选择。
QCode 同时支持 OpenAI Codex / GPT-5.6
你的 QCode 套餐配额可同时用于 Claude Code 与 OpenAI Codex CLI，共享额度，无需重复购买。
常见问题
DALL·E 3 还能用吗？要换成 GPT Image 2 吗？
在 OpenAI 的 API 上已不能用：官方 changelog 记载 dall-e-2 与 dall-e-3 于 2026 年 5 月 12 日从 API 移除，官方当时建议改用 gpt-image-2、gpt-image-1 或 gpt-image-1-mini。gpt-image-2 支持灵活尺寸与高保真图像输入，并能通过 edits 端点做局部修改；另据官方弃用表，gpt-image-1 计划于 2026 年 10 月 23 日下线，官方给出的替代是 GPT Image 2.5 系列（截至 2026-10-15）。
GPT Image 2 怎么计费？
按输出图片张数计费，每张 $0.30；generations 与 edits 同价，一次生成 n 张即 n × $0.30。size、quality、输入图片张数、mask、prompt 长度都不影响价格，失败的请求一律不计费。OpenAI 官方价是另一套口径：按图像 token 计费，图像输入 $8、缓存输入 $2、图像输出 $30 每 100 万 token，Batch 为 $4 / $1 / $15（2026-10-20 官方价表）。
国内怎么接入 GPT Image 2？
QCode 文档给出的 gpt-image-2 接入地址是 https://api.qcode.cc/qcode-img/v1（中国大陆默认推荐），香港与东南亚可用 https://asia.qcode.cc/qcode-img/v1，北美与欧洲可用 https://us.qcode.cc/qcode-img/v1（洛杉矶）。gpt-image-2 已列在 /models 目录中；当前可用性以 /models 目录与状态页为准，本页不做实时承诺。
QCode 套餐配额能用于 GPT Image 2 吗?
QCode 套餐配额可用于多个 CLI 工具（Claude Code、OpenAI Codex 等），一个 API Key 即可。gpt-image-2 已在 /models 目录列出，可用性以 /models 与状态页为准；图像请求按每张 $0.30 计入 dailyCostLimit。
gpt-image-2 实操补充：规格、接入、改图与报错
gpt-image-2 官方规格速查
截至 2026-10-15，OpenAI 官方 changelog 记载 GPT Image 2 于 2026 年 4 月 21 日发布，模型 ID 为 gpt-image-2，默认快照为 gpt-image-2-2026-04-21。官方模型页的端点表里，图像生成（v1/images/generations）、图像编辑（v1/images/edits）与 Batch（v1/batch）均标为支持；输入可以是文字和图片，输出为图片。
尺寸方面，官方列出的常用值有 1024x1024、1536x1024、1024x1536、2048x2048、2048x1152、3840x2160、2160x3840 和默认的 auto；自定义尺寸需同时满足：最长边不超过 3840px，两条边都是 16px 的倍数，长边与短边之比不超过 3:1，总像素在 655,360 到 8,294,400 之间。画质 quality 可选 low、medium、high 与默认的 auto。
- 输出格式：Image API 返回 base64 编码的图像数据，默认 png，也可以要 jpeg 或 webp；jpeg 与 webp 可以用 output_compression（0–100）控制压缩。
- 输入保真度：官方说明 gpt-image-2 会自动以高保真处理每一张输入图，不允许修改 input_fidelity，调用时省略这个参数即可。
- 透明背景：官方 changelog 记载自 2026 年 8 月 20 日起，gpt-image-2 以预览形式支持 background=transparent，需搭配 png 或 webp 输出，jpeg 不支持透明。
- 生成耗时：官方在限制说明里写到，复杂 prompt 可能需要最多 2 分钟。
- 内容审核：所有 prompt 与生成结果都会按 OpenAI 内容政策过滤，moderation 参数可选 auto（默认）或 low。
通过 QCode 调用 gpt-image-2：三步接入
QCode 文档给出的是一条与 OpenAI Images API 请求和响应格式兼容的图像专用路径：继续用 OpenAI 官方 SDK，把 base_url 换成 https://api.qcode.cc/qcode-img/v1，api_key 换成 QCode 的 API Key，模型名写 gpt-image-2，其余写法不变。当前能否调用请以 /models 目录与状态页为准。
不想先写代码，也可以打开 QCode 文档提到的在线 Playground（https://api.qcode.cc/qcode-img/），在浏览器里输入 API Key 和 prompt，直接试生成与改图。
- 第一步：注册 QCode，在控制台创建 API Key（以 cr_ 开头）；这把 Key 与 Claude Code、Codex 等工具共用。
- 第二步：请求写法与 OpenAI 一致。model 写 gpt-image-2；n 一次 1 到 4 张，超过 4 会直接返回 400，不会静默截断；不传 size 与 quality 时，生成接口默认 1024x1024 与 medium。返回图片的实际尺寸偶尔会与请求的 size 不同，以图片本身为准。
- 第三步：把客户端超时显式设到 180 秒或更高。QCode 文档特别提醒 OpenAI SDK 的默认超时偏短，经过自建反向代理或网关时，读超时也要调到 180 秒以上。
- 读取结果：响应里的 data[0].b64_json 是图片的 base64 数据，解码后写成文件即可；revised_prompt 是模型改写后的 prompt，可以选择展示。
- 默认限额：QCode 文档写明每个 API Key 每天 100 张、同时进行中的请求最多 2 个，generations 与 edits 共用，需要提升可以联系客服。
用 edits 改图：局部重绘与多图融合
改图请求发到 POST /qcode-img/v1/images/edits，必须用 multipart/form-data 上传文件，不能发 JSON。QCode 文档写明一次可以上传 1 到 8 张源图（PNG、JPEG 或 WebP），多张时重复同名的 image 字段；mask 可选，是带 alpha 通道的 PNG，透明区域就是要重绘的部分。
OpenAI 官方指南对 mask 的要求是：要编辑的图片和 mask 必须格式相同、尺寸相同、小于 50MB，且 mask 必须带 alpha 通道。官方还说明，GPT Image 的 mask 编辑完全基于 prompt，模型把 mask 当作参考，未必严格贴合它的形状；提供多张输入图时，mask 只作用于第一张。
- mask 回答的是哪里要改，prompt 描述的是改成什么；不给 mask 时，整张图都可能按 prompt 被重绘。
- 多图融合时，在 prompt 里写清每张图的角色，例如第一张是场景、第二张是要放进去的产品。
- 上传体积：QCode 文档写明单个文件不超过 25 MB、多个文件合计不超过 50 MB，超出会返回 413 image_too_large。
- 不必传 input_fidelity：gpt-image-2 恒以高保真处理输入图，QCode 会忽略 low 与 high，其他值返回 400。
常见报错与处理办法
QCode 图像接口的错误体沿用 OpenAI 的标准结构（error.type、error.code、error.message），按 HTTP 状态码和 code 判断即可。
- 400 unsupported_response_format：传了 response_format=url。这条接入只返回 b64_json。
- 400 unsupported_background：传了 background=transparent。OpenAI 官方 API 已以预览形式支持透明背景，但截至 2026-10-15，QCode 文档写明 /qcode-img/v1 只接受 auto 与 opaque。
- 400 stream_not_supported：传了 stream=true 或 partial_images，增量返回暂不支持。
- 422 unsupported_size：size 不在 auto、1024x1024、1024x1536、1536x1024、2048x2048 之内；官方 API 支持的 4K 等自定义尺寸在这条接入上不可用。
- 429 image_daily_limit 或 concurrency_exhausted：触发了每个 Key 的每日张数或并发上限，按响应头 Retry-After 等待后重试。
- 503 image_provider_unavailable、504 或客户端超时：按 Retry-After 指数退避重试（文档建议从 30 秒起，最多 3 次）；反复超时就精简 prompt 或减少输入图数量。
gpt-image-2 补充问答
gpt-image-2 是什么时候发布的？
OpenAI 官方 changelog 记载 GPT Image 2 于 2026 年 4 月 21 日发布，默认快照为 gpt-image-2-2026-04-21。之后 OpenAI 在 2026 年 9 月 8 日又发布了 GPT Image 2.5 Sunburst 与 GPT Image 2.5 Flare（截至 2026-10-15）。
gpt-image-2 支持哪些尺寸和画质？
OpenAI 官方 API 的常用尺寸是 1024x1024、1536x1024、1024x1536、2048x2048、2048x1152、3840x2160、2160x3840 和 auto，画质为 low、medium、high、auto。通过 QCode 的 /qcode-img/v1 调用时，size 可选 auto、1024x1024、1024x1536、1536x1024、2048x2048，quality 可选 low、medium、high，其他尺寸会返回 422。
gpt-image-2 能直接返回图片 URL 吗？
不能。官方 Image API 返回的是 base64 编码的图像数据；QCode 的接入同样只返回 b64_json，传 response_format=url 会返回 400。把 b64_json 解码后保存成文件，或在网页里用 data URL 显示即可。
能用 gpt-image-2 生成透明背景的 PNG 吗？
在 OpenAI 官方 API 上可以：官方 changelog 记载自 2026 年 8 月 20 日起，gpt-image-2 以预览形式支持 background=transparent，需搭配 png 或 webp。截至 2026-10-15，通过 QCode 的 /qcode-img/v1 调用时不支持，transparent 会返回 400，background 只能用 auto 或 opaque。
调用 gpt-image-2 总是超时怎么办？
先把客户端超时调到 180 秒以上。OpenAI 官方说明复杂 prompt 可能需要最多 2 分钟；QCode 文档要求 SDK 显式设置不低于 180 秒的 timeout，经过自建反向代理时也要把读超时调到 180 秒以上。遇到 504 或客户端超时可以直接重试，反复超时就精简 prompt 或减少输入图。
gpt-image-2 和 GPT Image 2.5 有什么区别？
按 OpenAI 官方图像生成指南（截至 2026-10-20），GPT Image 2.5 Sunburst 与 Flare 新增了 xhigh 与 max 两档画质，gpt-image-2 的画质最高到 high；官方建议新接入优先选用 2.5 系列，Sunburst 侧重编辑精度，Flare 侧重快速、高质量的日常出图。QCode 上可调用的图像模型与当前计费以 /models 为准。
在国内怎么付款开通，用 QCode 调用 gpt-image-2？
注册 QCode 后先充值、再选套餐，然后在控制台创建 API Key。人民币可用支付宝或微信支付，美元可用 Visa / Mastercard / AMEX 信用卡、Apple Pay、Google Pay，也支持加密货币（多币种多网络），无需境外信用卡，全程自助。不想包月？按量包 ¥26 起买一笔额度，7 天内用完为止（人民币充值 ¥30 起）；已有个人套餐的用户额度不够时买加油包。gpt-image-2 按输出图片张数计费，每张 $0.30，详见 /models。