GPT Image 2.6 API 接入教程：Flare 与 Sunburst 选型、GIF 与 SVG 输出实操

先做三个决定：线路、模式、输出格式

在写第一行请求之前，把三件事定下来，后面就不用反复改代码。

第一，线路选 Flare 还是 Sunburst。 无特殊需求默认 Flare：出图更快，适合快速迭代和批量出图。只有当你需要在 medium 及以上质量做多轮编辑、并且很在意角色/产品/版式的一致性时，才切到 Sunburst。两者参数、用法、价格完全相同，所以切换成本只是改一个模型 ID。

第二，模式选文生图还是图生图。 从一个提示词出发就是文生图；手里已有 1–16 张源图、要在其基础上改，就是图生图。注意输出格式的可选范围不同：gif 和 svg 只在文生图可用，图生图只能输出 png、jpeg、webp。

第三，输出格式选静态还是动图/矢量。 默认 png；要透明背景就用 png 或 webp；要动图走 gif；要可缩放的矢量走 svg。

三个决定落到代码上，就是模型 ID 加上 output_format 两个字段的取值。先把它们写成常量，比边调边改省事得多。

四个模型 ID 与 Flare、Sunburst 的选型判断

模型 ID 由「线路 + 模式」两段拼成，一共四个：

• gpt-image-2.6-flare/text-to-image

• gpt-image-2.6-flare/image-to-image

• gpt-image-2.6-sunburst/text-to-image

• gpt-image-2.6-sunburst/image-to-image

命名规律很直白：前半段是线路，后半段是模式。请求体里的参数名、取值范围、计价口径在两条线路上完全一致，所以你可以用一个函数封装，把线路当参数传进去。

什么时候必须用 Sunburst

Sunburst 更重细节，在 medium 及以上质量做多轮编辑时，细节更一致，典型场景是固定角色、固定产品外观、固定版式的一轮轮微调。如果你的流程是「先生成，再改三次」，Sunburst 的收益会体现在后面几轮。

什么时候留在 Flare

单张出图、批量铺量、快速看提示词效果——这些场景 Flare 更快就是更好的选择。因为两者价格完全相同，选 Flare 不会带来任何成本劣势。

实操建议：开发阶段统一用 Flare 跑通参数与格式，进入生产后再针对需要多轮编辑的用例切换线路。模型页可以先看 Flare 文生图 与 Sunburst 文生图 的字段说明。

文生图关键参数怎么填

文生图的核心参数有七个，逐个说明取值与约束。

quality 与 resolution

quality 取 low / medium / high / xhigh / max，决定细节档位，也是 GIF 的唯一计价依据。resolution 取 1K / 2K / 4K，默认 1K。这两个参数共同决定单张价格，也是成本控制的两个旋钮。

complexity

取 low / medium / high，默认 high，指的是规划层级。它和 quality 相互独立：一个管构图规划的深度，一个管成像细节档位。不要因为调低了 quality 就顺手改 complexity，两者不是联动关系。

aspect_ratio

取 auto 或 15 种比例之一。这里有一条容易踩的规则：生成 GIF 时 aspect_ratio 不传或传 auto，因为 GIF 的比例由 frame_size 决定，两者冲突没有意义。

output_format 与 output_compression

output_format 取 png（默认）/ jpeg / webp / gif / svg。output_compression 取 0–100，只对 jpeg、webp 生效；给 png 传压缩参数不会按你的预期工作。

background

取 auto / opaque / transparent。transparent 必须搭配 png 或 webp，想要透明背景又选了 jpeg，就得改格式。

把这些约束记住一条就够用：格式会反过来限制其他参数——gif 锁死比例来源，jpeg/webp 才吃压缩，transparent 只认 png/webp。

GIF 输出：frame_size、帧数与尺寸上限

GIF 只有文生图能出，参数集中在帧上。

frame_size

每帧的像素宽高，写成 512x512 这种「宽x高」形式，两侧都必须是 16 的倍数，默认 512x512。它同时决定 GIF 的整体比例，所以这时不要再传 aspect_ratio。注意不接受 1:1 这类比例写法，必须是像素值。

frame_count 与 frame_duration_ms

frame_count 取 2–16，默认 9。有一条尺寸相关的限制：768x768 最多 12 帧。frame_duration_ms 不小于 20，默认 200，按 10ms 取整。

三条硬上限

GIF 拼图整体还要满足：每边不超过 3840、总像素不超过 8,294,400、长宽比不超过 3:1。超出会在提交阶段就被拒绝，且不计费，所以这类错误不会带来成本，但会浪费你的调试时间。

一个最小可用的 GIF 请求体：

{
  "model": "gpt-image-2.6-flare/text-to-image",
  "prompt": "a bouncing paper plane on white",
  "output_format": "gif",
  "frame_size": "512x512",
  "frame_count": 9,
  "frame_duration_ms": 200,
  "quality": "medium"
}

要出 13–16 帧，frame_size 用 512x512 或更小；768x768 最多 12 帧。

SVG 输出怎么用，价格怎么算

SVG 同样只在文生图可用，图生图不接受该格式。用法上只需把 output_format 设为 svg，其余参数按常规文生图填；background 想透明时仍要留意格式搭配规则。

计价口径

SVG 按同档位 PNG 的价格再加 $0.030 计算。比如 low 1K 的 PNG 是 $0.023，同档 SVG 就是 $0.053；high 2K 的 PNG 是 $0.090，SVG 是 $0.120。档位越高 SVG 越贵，但加的那 $0.030 不变。

使用建议

SVG 适合徽标、图标、示意图这类需要无损缩放的目标。如果你的下游管线最终还是要位图，直接用 png 更省事——多付的矢量加价换不来收益。

图生图：源图、蒙版与标注图二选一

图生图输入是 1–16 张源图，格式限 jpeg / png / webp，输出只有 png / jpeg / webp。

mask_url 与 markup_url 只能二选一

• mask_url：与第一张源图同尺寸的 RGBA PNG，其中透明像素表示要修改的区域。

• markup_url：透明 PNG 标注图，在图上圈出要改的位置；标注本身不会出现在生成结果里。

两者互斥，同时传会被拒绝。选择逻辑很简单：想让系统精确只动某块像素，用蒙版；只想指出「大概这个地方」、不希望被硬边界框住，用标注图。

遮罩外也可能变

用 mask_url 时要有心理预期：遮罩以外的区域也可能出现轻微变化。如果你的业务要求未选中区域像素级不变，在图生图这条路上无法保证，应改为在合成阶段自行处理。

计费

图生图沿用文生图的价格表，每张参考图另加 $0.012。low 1K 传 1 张是 $0.035，传 16 张是 $0.215。只传真正需要的参考图。

请求体示例：

{
  "model": "gpt-image-2.6-flare/image-to-image",
  "prompt": "change the background to warm sunset",
  "image_urls": ["https://your-cdn/source.png"],
  "mask_url": "https://your-cdn/mask.png",
  "output_format": "png"
}

字段细节可对照 Flare 图生图 页面。

成本估算：按质量档与尺寸算清单张价格

先把三条计价口径记住：

• 文生图（png/jpeg/webp）：由 quality 与 resolution 共同决定单张价格。

• SVG：同档位 PNG 价再加 $0.030。

• GIF：只按 quality 计价，与分辨率无关：low $0.070、medium $0.124、high $0.150、xhigh $0.266、max $0.598。

• 图生图：同表价格，每张参考图另加 $0.012。

怎么估一张

四步走：确定模式（文生图还是图生图）→ 确定格式（gif 只看质量，svg 加 $0.030，其余按质量×分辨率）→ 查对应档位单价 → 图生图再加上 $0.012 × 参考图张数。文生图的常用档位：low 1K $0.023，medium 1K $0.041，high 1K $0.049，high 2K $0.090，high 4K $0.160。

哪些情况不计费

提交阶段被拒的请求全额退回，不扣费。包括参数不合法（比如给 background=transparent 配了 jpeg、给 gif 传了 aspect_ratio）以及 GIF 尺寸超限。这意味着参数校验错误不会烧钱，但会拖慢迭代，建议在客户端先做一轮校验。

全部 15 个档位见 价格页。想对比上一代的计价方式，可以看 GPT Image 2.5 Flare 文生图。

总结成一句：默认 Flare + 文生图 + png，遇到多轮编辑再切 Sunburst，需要动图或矢量时再改 output_format。