GPT Image 2.6 报错 No supported sheet fits GIF frames、缺少 svg.model 怎么解决

GPT Image 2.6 输出 GIF 和 SVG 时的常见报错:GIF 尺寸超限、frame_count 和 frame_duration_ms 超出范围、缺少 svg.model、SVG 只能 n=1,以及 complexity 等新参数的用法和限制。

一支画笔的线稿,配标题 GPT Image 2.6 GIF & SVG

摘要:GPT Image 2.6 上线首日的报错大多来自 GIF 和 SVG 的新限制:1024x1024 的 GIF 拼不进一张图,frame_count 只能填 2–16,SVG 必须带 svg.model 且只能 n=1。规则来自 OpenAI 2026 年 11 月 4–5 日更新的 API 规范;报错原文是 OpenAI 对我们实际请求的返回,或引自 OpenAI 开发者论坛。

适用:Images API(/v1/images/generations、/v1/images/edits)上的 gpt-image-2.6-sunburst 和 gpt-image-2.6-flare,以及 Responses API 里的 image_generation 工具。最后核对:2026-11-05。

你看到的报错跳到
No supported sheet fits 9 GIF frames at size '1024x1024'GIF 尺寸超限
Invalid 'frame_count' for GIF output. 或 Invalid 'frame_duration_ms'帧数和帧时长超出范围
Complexity 'low' is not supported for this image model.Responses API 里的 complexity 报错
SVG generation requires 'svg.model'.缺少 svg.model
The 'n' parameter is not supported for SVG generation. Use n=1.SVG 只能 n=1

本文只讲报错。想看怎么做,可以读 GPT Image 2.6 GIF 教程、用 GPT Image 2.6 生成可编辑的 SVG(英文)和 GPT Image 2.6 API 价格。

GPT Image 2.6 API 新增了什么

如果你要准备透明标注层,先看圈选修图的文件与请求检查。如果请求已成功、但上一轮修改被覆盖或产品细节发生变化,应按连续修图的版本选择与验收检查输入和输出;这类结果问题不能直接归因于下面的参数报错。

GPT Image 2.6 有两个型号:gpt-image-2.6-sunburst 偏重画质和多次编辑的一致性,gpt-image-2.6-flare 偏重速度。两者在 GPT Image 2.5 已有参数的基础上,新增了下面这些参数。

参数取值规范里的规则
complexitylow、medium、high规划构图的投入,和 quality 分开控制;不传时用模型默认值。
output_format新增 gif、svggif 生成和编辑都能用;svg 只能用于生成。
frame_count2–16,默认 9只能配合 output_format: "gif" 使用。
frame_duration_ms20–2000,默认 200只用于 GIF,按 10 毫秒取整。
svg{model, reasoning}指定负责写 SVG 代码的模型。
markup(编辑)透明 PNG2.5 和 2.6 都支持,不能和 mask 同时使用。

GIF 输出需要所选模型开通 GIF 预览权限。GIF 和 SVG 都不支持流式返回、部分图像和 output_compression。

不想写代码?在 Ofox Chat 里直接说「用 GPT Image 2.6 画……」,再选 Flare 或 Sunburst。Chat 输出 PNG 或 JPEG;GIF 要通过 API 生成。

No supported sheet fits GIF frames

No supported sheet fits 9 GIF frames at size '1024x1024'. Invalid size '3072x3072'. Requested resolution exceeds the current pixel budget.

GPT Image 2.6 生成 GIF 时,会把所有帧拼在一张图上一起生成;拼起来的尺寸超过接口上限,就会返回 No supported sheet fits 报错(image_generation_user_error)。报错里的数字和句末的原因会随请求变化:

No supported sheet fits 9 GIF frames at size '1536x1024'. Invalid size '4608x3072'. The longest edge must be less than or equal to 3840.
No supported sheet fits 2 GIF frames at size '1024x1024'. Invalid size '4096x2048'. The longest edge must be less than or equal to 3840. Invalid size '2048x4096'. The longest edge must be less than or equal to 3840.

1024x1024 下减少 frame_count 没有用:我们实测 2、3、4、9 帧全部报错,因为拼出来的图最长边最少也有 4096 像素。

  1. 把每帧尺寸改成 512x512:
    {"model": "gpt-image-2.6-flare", "output_format": "gif",
     "size": "512x512", "quality": "low", "frame_count": 4,
     "prompt": "A small orange fox mascot waving"}
  2. 需要更大的动图,就在生成后再放大。

怎么确认修好了:响应里有 "output_format": "gif",解码后的文件以 GIF89a 开头。512x512 下,我们拿到的 4 帧 GIF 是 247 KB,9 帧约 480 KB,16 帧 977 KB。

还不行的话:从请求里去掉 partial_images、stream、mask 和 output_compression。

站内文档:图片接口参考:请求和响应字段列出了这个接口支持的全部参数。

Invalid frame_count or frame_duration_ms for GIF output

Invalid 'frame_count' for GIF output. Received 40. Use an integer from 2 to 16, or omit 'frame_count' to use 9.
Invalid 'frame_duration_ms': integer below minimum value. Expected a value >= 20, but got 5 instead.

frame_count 和 frame_duration_ms 这两条报错都表示填的值超出了范围。OpenAI 的 GIF 指南里写 frame_count 是 2–64,但 API 参考和接口实际只认到 16:开发者论坛的一篇反馈里,17、20、32、64 帧全部报错,16 帧正常。

  1. frame_count 填 2 到 16 的整数,或者不传,默认 9 帧。
  2. frame_duration_ms 填 20 到 2000,或者不传,默认 200 毫秒。
  3. 这两个参数只在 output_format: "gif" 时传。

怎么确认修好了:用能逐帧查看的工具打开 GIF。我们用 frame_count: 4、frame_duration_ms: 100 请求,拿到了 4 帧、每帧 100 毫秒的 GIF。

Complexity ‘low’ is not supported for this image model

Complexity 'low' is not supported for this image model.

2.6 上线后,有开发者在 Responses API 的 image_generation 工具里调用 gpt-image-2 时收到 Complexity 'low' is not supported for this image model 报错(image_generation_user_error,param: complexity、code: invalid_value),而他们根本没传 complexity。据开发者论坛的讨论,外层的 reasoning.effort 被当作 complexity 传给了生图工具,gpt-image-2 不接受这个参数,complexity 只适用于 GPT Image 2.6。其他用户也确认能复现,并表示已经反馈给 OpenAI。

  1. 不需要 reasoning.effort 的话,从 Responses 请求里去掉它。
  2. 路由或 SDK 总会自动带上它的话,设成 "effort": null,这是帖子里给出的临时办法。
  3. complexity 只发给 gpt-image-2.6-sunburst 或 gpt-image-2.6-flare。

怎么确认修好了:Responses 调用不再返回 400,而是返回 image_generation_call 结果。

SVG generation requires svg.model

SVG generation requires 'svg.model'.

output_format 设为 svg、但请求里没有 svg.model 时,GPT Image 2.6 会返回 SVG generation requires 'svg.model' 报错(invalid_request_error)。SVG 输出分两步:先由图像模型画一张参考图,再由第二个模型(SVG 作者模型)把它写成 SVG 代码。规范写明,账号开通了 SVG 模型选择后 svg.model 必填;没开通时使用默认的作者模型。

  1. 加上 svg 对象,并且只生成一张:
    {"model": "gpt-image-2.6-sunburst", "output_format": "svg",
     "n": 1, "prompt": "Flat orange fox head logo",
     "svg": {"model": "<SVG 作者模型>",
             "reasoning": {"effort": "medium"}}}
  2. 外层的 model 填图像模型,svg.model 填负责写 SVG 的模型。svg.reasoning.effort 可以不传,能填哪些值取决于作者模型。

怎么确认修好了:响应里出现 svg_usage,包含作者模型的名字和它的 token 用量。

还不行的话:确认账号已开通 SVG 输出和 SVG 模型选择,并记下完整的报错内容;API 错误码与重试指南说明了哪些报错值得重试。

n is not supported for SVG generation

The 'n' parameter is not supported for SVG generation. Use n=1.

GPT Image 2.6 每次请求只能生成一张 SVG。把 n 设为 1 或者直接去掉;需要几张,就发几次请求。

怎么确认修好了:报错消失,data 里只有一项。

相关文档

来源

常见问题

GPT Image 2.6 提示 “No supported sheet fits GIF frames” 是什么原因?
GIF 的所有帧要拼在一张图上生成,拼出来的尺寸超过了接口上限。我们实测 1024x1024 从 2 帧到 9 帧全部报错,改成 512x512 后最多 16 帧都能正常返回。
“SVG generation requires 'svg.model'” 怎么解决?
在请求里加上 svg 对象,用 model 字段指定负责写 SVG 的模型,并保持 n=1。OpenAI 规范写明,账号开通了 SVG 模型选择后,svg.model 是必填项。
frame_count 和 frame_duration_ms 能填多少?
frame_count 填 2 到 16 的整数,默认 9;frame_duration_ms 填 20 到 2000 毫秒,默认 200,按 10 毫秒取整。两者都只能配合 output_format gif 使用。