[ PROMPT_NODE_27842 ]
video-api
[ SKILL_DOCUMENTATION ]
# Sora 视频 API 快速参考
保持此文件简洁;完整文档位于 OpenAI 平台文档中。
## 模型
- sora-2: 更快,迭代灵活
- sora-2-pro: 保真度更高,速度较慢,成本更高
## 尺寸 (按模型)
- sora-2: 1280x720, 720x1280
- sora-2-pro: 1280x720, 720x1280, 1024x1792, 1792x1024
注意:更高的分辨率通常会产生更好的细节、纹理和运动一致性。
## 持续时间
- seconds: "4", "8", "12" (字符串枚举;通过 API 参数设置;正文文本不会改变片段长度)
较短的片段通常能更可靠地遵循指令;考虑拼接多个 4 秒片段以获得精度。
## 输入参考
- 可选的 `input_reference` 图像 (jpg/png/webp)。
- 输入参考应与目标尺寸匹配。
## 作业与状态
- 创建是异步的。状态值:queued (排队中), in_progress (进行中), completed (已完成), failed (失败)。
- 建议每 10-20 秒轮询一次,或在生产环境中使用 Webhook。
## 端点 (概念)
- POST /videos: 创建作业
- GET /videos/{id}: 获取状态
- GET /videos/{id}/content: 下载视频数据
- GET /videos: 列表
- DELETE /videos/{id}: 删除
- POST /videos/{id}/remix: 重混已完成的作业
## 下载变体
- video (mp4)
- thumbnail (webp)
- spritesheet (jpg)
下载 URL 在约 1 小时后过期;请将文件复制到你自己的存储空间以供保留。
## 防护栏 (内容限制)
- 仅限适合 18 岁以下观众的内容
- 无版权角色或版权音乐
- 无真实人物(包括公众人物)
- 目前拒绝包含人脸的输入图像