GPT Image 2 API size 枚举能写死吗
编辑部 发布 2026-09-06 最后更新 2026-09-08
GPT Image 2 API 的 size 应按当前文档与模型目录配置,不能从网页尺寸标签直接推导生产请求。提交前核对该模型支持的参数,出现 422 时按错误详情修正;动态规格以官网当前为准。
GPT Image 2 在 Flux Art 网页端提供低、中、高质量,以及 1K、2K、4K 预设和有效自定义尺寸,但 OpenAPI 的 size 具体枚举不能据此自行推导。动态规格以官网当前为准,接口字段按当前官方说明配置,不把旧截图或社区示例当长期契约。
为什么网页档位和 API 字段要分开
网页端面向用户展示产品选项,API 请求则需要当前接口接受的机器值。两者可能更新节奏不同,因此接入时应:
- 把
size做成服务端配置,不散落在业务代码; - 上线和模型切换前核对当前文档与控制台;
- 不把未验证值批量发送到生产;
- 收到 422 时读取
details,不要原样重试。
网页选型方法见质量与尺寸说明,模型目录可通过GET /models 教程核对。
校验失败后怎样处理
修正 size 会改变请求内容,应使用新的幂等键。保存 request_id 和脱敏请求摘要,按422 validation_error 排查确认是否还有 model、mode、prompt 或素材字段问题。
关于「GPT Image 2 API size 枚举能写死吗」的常见问题
- 网页端分辨率能直接当 API 枚举吗?
- 不能直接画等号。网页产品档位与 API 请求枚举应分别按官方当前说明核对。
- 旧示例能永久写进代码吗?
- 不建议。动态参数应集中配置,并在上线或模型切换前重新确认。
- size 校验失败怎样处理?
- 读取 422 details,修正字段后使用新的幂等键提交。