• Body 必须是 JSON 对象，不支持 multipart。
  • model 必填；input 必须是字符串或数组，并且最终提取出非空文本。
  • 只提供图片而没有 prompt 会失败。
  • 多张图片只取第一张；没有多参考图、角色素材或视频素材的稳定入口。
  • 只有 seconds、size、metadata 会被明确转换；temperature、messages、aspect_ratio 不会自动变成 Sora 参数。

response.incomplete 或 SSE 断开只表示这次观察未完成，保存 Response ID 后继续 GET。只有明确的 failed 或 cancelled 才结束任务。

状态码排查方向
401/403青云 Key、模型权限、额度
400JSON 结构、空 input、尺寸或时长
404Response ID 或 task ID 不属于当前账号
429/5xx降低创建并发，延迟重试查询

本地图片上传请看统一格式上传图片。