GPT Image 2.5 解读：sunburst / flare 双模型、xhigh-max 质量档与任意分辨率

2026-09-08 前后，OpenAI 图像模型家族悄悄扩了一代：GPT Image 2.5。这次没有可在浏览器里打开的官方公告页可指——截至 2026-09-09，OpenAI 官方文档域（developers.openai.com / platform.openai.com）对本站返回 403——但证据落在官方 SDK 的类型定义里：openai-python v3.10.0 与 openai-node v7.12.0 的 release notes 均包含同一条 feature：add GPT Image 2.5 models and image options。本文全部事实逐条对照这两个当日在 GitHub 上可重抓的来源（引用清单见文末 officialReferences），无法核实的信息（定价、两款模型的定位差异）明确标注，不做推测。

1. GPT Image 2.5 是什么

GPT Image 2.5 是 OpenAI Images API 图像生成模型家族的新一代，包含两款模型：

• gpt-image-2.5-sunburst
• gpt-image-2.5-flare

两款各有对应的日期快照：gpt-image-2.5-sunburst-2026-09-08 与 gpt-image-2.5-flare-2026-09-08。这四个 ID 已进入 openai-python v3.10.0 的 ImageModel 枚举，同时出现在三处 API 的模型列表里：images.generate（文生图）、images.edit（图像编辑）和 Responses API 的 image_generation 工具。

需要强调的是：SDK 类型只回答"有哪些模型、接受哪些参数"。两款模型的定位差异（谁是旗舰、适用场景区别）、定价、以及是否有官方公告的配套说明，SDK 里没有；截至 2026-09-09 也因官方文档域 403 无法核实。在官方说明可考之前，把两者当同能力档处理是更稳妥的做法。

2. 模型清单：两代同框

openai-python v3.10.0 的 ImageModel 枚举（当日源码）现在同时列出：

两件事值得注意：其一，gpt-image-2 系列没有被移除，现有代码不受影响；其二，枚举里有 dall-e-2 / dall-e-3 不代表可调用——它们在 2026-05-12 已从 API 硬下线（见本站《OpenAI 模型更新日志（2026 持续更新）》），枚举只是类型层面的历史残留。

3. 新能力逐项拆解（只说 SDK 写了的）

3.1 quality：新增 xhigh 与 max

SDK 对 quality 参数的描述是分层写的：GPT image 模型支持 low / medium / high；gpt-image-2.5-sunburst 与 gpt-image-2.5-flare（含 2026-09-08 快照）在此之上还支持 xhigh 与 max；默认 auto。Python 类型里 quality 的完整取值集合为 standard（DALL·E 遗留）/ hd（DALL·E 遗留）/ low / medium / high / xhigh / max / auto。

各档位与成本、时延的量化关系 SDK 未给出（经验值：越高档越清晰、越慢也越贵），选档建议用同一组 prompt 横向对比。

3.2 size：任意分辨率的三条硬规则

对 2.5 与 gpt-image-2 系列，SDK 描述支持任意分辨率字符串 WIDTHxHEIGHT（官方示例 1536x864），并给出三条明确限制：

1. 宽和高都必须被 16 整除；
2. 宽高比限定在 1:3 到 3:1 之间；
3. 上限 3840x2160；超过 2560x1440 的分辨率属于实验性（experimental）。

此外还有一句兜底：请求尺寸须满足模型当前的像素与边缘限制（pixel and edge limits）。标准尺寸 1024x1024 / 1536x1024 / 1024x1536 继续可用，auto（自动定尺寸）也支持。几个合规的自定义例子：2048x1152（16:9，两边都被 16 整除）、1920x1088（1088 除以 16 得 68）、1024x3072（1:3 极限比例）。

3.3 background：透明背景在 2.5 上转正

background 参数取 transparent / opaque / auto（默认）。SDK 描述的措辞差异值得逐字看：对 2.5 两款（含快照）直接写支持 opaque 与 transparent 背景；而对 gpt-image-2 与 gpt-image-2-2026-04-21，同一能力标注的是 in preview。使用 transparent 时必须把输出格式设为 png 或 webp。

3.4 其余参数沿用

images.generate 的参数集合（当日源码）为：prompt（必填）、background、model、moderation（low / auto）、n、output_compression、output_format（png / jpeg / webp）、partial_images、quality、response_format、size、style（vivid / natural，DALL·E 遗留）、user、stream。images.edit 在此基础上有 image（必填）、mask、input_fidelity（high / low），其 quality 取值不含 DALL·E 的 hd。这些字段在 2.5 上没有声称新增或移除——"新选项"主要就是上文三处：质量档、尺寸规则、背景标注。

4. 上手代码（SDK 源码核对版）

以下示例逐行对照 openai-python v3.10.0 的参数类型定义。诚实声明：这是文档核对版，不是真机验证版——截稿时本站没有可用 API key 实跑；参数名与取值全部能在第 3 节引用的源码里指出。

4.1 文生图：16:9 高分辨率 + 高质量档

from openai import OpenAI
import base64
import pathlib

client = OpenAI()

result = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt="极简风格的茶叶品牌主视觉，米白背景，一枝山茶花，柔和侧光",
    size="2048x1152",      # 宽高都被 16 整除，比例 16:9，未超 2560x1440
    quality="high",
    n=1,
)

pathlib.Path("out.png").write_bytes(base64.b64decode(result.data[0].b64_json))

4.2 透明背景出图

result = client.images.generate(
    model="gpt-image-2.5-flare",
    prompt="吉祥物贴纸，单独主体，无背景",
    background="transparent",   # 必须搭配 png / webp
    output_format="png",
    quality="xhigh",
    size="1024x1024",
)

4.3 Node 侧同款调用

import OpenAI from "openai";

const client = new OpenAI();

const result = await client.images.generate({
  model: "gpt-image-2.5-flare",
  prompt: "isometric SaaS dashboard icon, soft gradients",
  size: "1536x864",
  quality: "high",
});

const b64 = result.data[0].b64_json; // 与 Python 侧同构

4.4 图像编辑

result = client.images.edit(
    model="gpt-image-2.5-sunburst",
    image=open("product.png", "rb"),
    prompt="把背景换成纯色渐变，保留产品主体与阴影",
    input_fidelity="high",
)

5. 从 GPT Image 2 迁移到 2.5 要改什么

迁移步骤：升级 SDK 版本（Python ≥ v3.10.0 / Node ≥ v7.12.0），把 model 换成 2.5，其余代码不动；需要透明背景的组合检查输出格式；用同一组 prompt 对比新旧输出后决定是否全面切换。gpt-image-2 与快照仍在枚举中，截至 2026-09-09 SDK 内无弃用标注——不需要因为 2.5 的出现而紧急迁移。

本站的 GPT Image 2 实战教程（《GPT Image 2 API 实战：从文生图到图像编辑》）里的编辑流程、蒙版用法对 2.5 同样适用；提示词工程方法见《GPT Image 2 提示词公式与商业使用边界》。

6. 本文没说的：定价与定位

按本站的信源纪律，以下信息当日未核实，本文不做断言：

• 定价：官方文档域 2026-09-09 对本站 403，SDK 类型不含价格；GPT Image 2 的历史单价不能默认沿用。
• 两款模型的定位差异：SDK 只有 ID 与能力描述，没有旗舰/轻量之分。
• 官方公告与 changelog 原文：等官方域可达后，建议到 changelog 复核一次 GA 状态与配套说明；本站《OpenAI 模型更新日志（2026 持续更新）》会同步补条目。

自查方法：用可访问官方文档的网络环境打开 platform.openai.com 的图像定价页与 images 文档页，核对 model 列表是否含 2.5 及其单价。

7. 常见错误与排查

• 报错不认识 model：SDK 版本太旧。v3.10.0 之前的 openai-python 与 v7.12.0 之前的 openai-node 枚举里没有 2.5，先升级。
• size 被 16 整除的坑：1920x1080 不合法（1080 不能被 16 整除），要写 1920x1088；3840x2160 合法但属实验性区间（超过 2560x1440）。
• 透明背景不生效：检查 output_format 是否为 png 或 webp——jpeg 不支持透明通道。
• 拿到的不是 base64：GPT image 系列的返回在 result.data[0].b64_json；不要按 DALL·E 时代的 url 用法解析。
• 枚举里有 dall-e-2 / dall-e-3 却调用失败：类型残留，这两个模型 2026-05-12 已硬下线，换 GPT Image 家族。

8. 下一步

• 《GPT Image 2 API 实战：从文生图到图像编辑》：编辑、蒙版与多图合成的完整流程，对 2.5 同样适用。
• 《GPT Image 2 提示词公式与商业使用边界》：5 段式提示词公式与 Usage Policy 自查清单。
• 《GPT Image 2 vs Midjourney vs DALL·E 3：三大图像生成模型实战对比（2026）》：选型视角的横向对比。
• 《openai-python 3.9 / 3.10 与 openai-node 7.11 / 7.12 更新解读：prompt cache 诊断、API key 过期与 GPT Image 2.5》：同一批 SDK 更新的完整解读。
• 《OpenAI 模型更新日志（2026 持续更新）》：时间线视角的模型发布记录。