GPT Image 2 API prompt 校验要求
编辑部 发布 2026-09-02 最后更新 2026-09-02
prompt 必填且至少含 3 个非空白字符。收到 400 或 422 时，先检查字段与长度并读取 error.details；修正后用新幂等键提交。
GPT Image 2 API 的 prompt 是必填字段，至少要有 3 个非空白字符。只有空格、缺少字段或去除首尾空白后长度不足，都不能作为有效提示词。
校验失败按什么顺序排查
- JSON 中是否真的存在
prompt； - 值是否为字符串；
- 去除首尾空白后是否至少 3 个字符；
model、mode、count等其他必填字段是否同时有效；- 响应
error.details指向哪个字段。
完整的 422 处理方式见validation_error 清单，错误码总览见API 错误码说明。
修正后如何重发
参数修正后，请求内容已经变化，应使用新的 Idempotency-Key。记录脱敏请求摘要、request_id 与校验详情，避免把 API Key 或完整敏感提示词写进普通日志。
关于「GPT Image 2 API prompt 校验要求」的常见问题
- prompt 只传空格可以吗?
- 不可以。要求至少 3 个非空白字符。
- 校验失败后要沿用原幂等键吗?
- 请求内容已经修正，应把它作为新请求并使用新键；同一请求的网络超时或 5xx 重试才沿用原键。
- 应该优先看哪个错误字段?
- 先看 error.code、message、details 和 request_id，用 details 定位具体字段。