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 的新限制: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 已有参数的基础上,新增了下面这些参数。
| 参数 | 取值 | 规范里的规则 |
|---|---|---|
complexity | low、medium、high | 规划构图的投入,和 quality 分开控制;不传时用模型默认值。 |
output_format | 新增 gif、svg | gif 生成和编辑都能用;svg 只能用于生成。 |
frame_count | 2–16,默认 9 | 只能配合 output_format: "gif" 使用。 |
frame_duration_ms | 20–2000,默认 200 | 只用于 GIF,按 10 毫秒取整。 |
svg | {model, reasoning} | 指定负责写 SVG 代码的模型。 |
markup(编辑) | 透明 PNG | 2.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 像素。
- 把每帧尺寸改成 512x512:
{"model": "gpt-image-2.6-flare", "output_format": "gif", "size": "512x512", "quality": "low", "frame_count": 4, "prompt": "A small orange fox mascot waving"} - 需要更大的动图,就在生成后再放大。
怎么确认修好了:响应里有 "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 帧正常。
frame_count填 2 到 16 的整数,或者不传,默认 9 帧。frame_duration_ms填 20 到 2000,或者不传,默认 200 毫秒。- 这两个参数只在
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。
- 不需要
reasoning.effort的话,从 Responses 请求里去掉它。 - 路由或 SDK 总会自动带上它的话,设成
"effort": null,这是帖子里给出的临时办法。 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 必填;没开通时使用默认的作者模型。
- 加上
svg对象,并且只生成一张:{"model": "gpt-image-2.6-sunburst", "output_format": "svg", "n": 1, "prompt": "Flat orange fox head logo", "svg": {"model": "<SVG 作者模型>", "reasoning": {"effort": "medium"}}} - 外层的
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 里只有一项。
相关文档
来源
- OpenAI,Introducing Images 2.6,2026 年 11 月 4 日
- OpenAI API 规范,commit 5882fdd:GIF、SVG 输出和新图像参数,2026 年 11 月 5 日
- OpenAI 开发者社区,Responses API with gpt-image-2 gives Complexity ‘low’ is not supported,2026 年 11 月 5 日
- OpenAI 开发者社区,GPT Image 2.6 GIF frame limit: guide says 64, API enforces 16,2026 年 11 月 5 日
- OfoxAI 2026 年 11 月 5 日的实测请求(上文的报错原文)
常见问题
- 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 使用。


