创建视频
统一视频
创建视频
使用 POST /v1/video/create 通过统一视频格式提交 Sora 异步生成任务。
POST
创建视频
创建视频
Sora 统一视频入口使用POST /v1/video/create,请求体为 JSON。与 OpenAI 格式的 Sora 视频生成 不同,本接口使用 images、orientation、size、duration 等字段,并支持 watermark、private、style、storyboard 等 Sora 专有选项。
- 路由入口是
POST /v1/video/create。 - 参考图通过
images数组传入 URL 列表,文生视频可传空数组。 - 常见模型示例为
sora-2,以当前渠道实际可用模型为准。 - 提交成功后返回任务
id与status,后续用 查询任务 轮询结果。
方法与路径
请求示例
响应示例
object、model、progress、created_at、size、detail 等字段,结构与 OpenAI VIDEO 返回格式一致。
认证
Body
参考图链接列表。文生视频可传
[]。模型名称,例如
sora-2。画面方向。
portrait 表示竖屏,landscape 表示横屏。提示词。
输出规格。
small 一般对应 720p。视频时长(秒)。默认常为
10,可选 10、15、25(sora-2-pro 可用更长时长)。是否保留水印。默认为
true:会优先尝试无水印,失败时可能兜底为有水印。传 false 会强制无水印,遇到去水印错误时可能自动重试。是否隐藏视频。
true 时视频不会发布,且无法进行 remix;默认为 false。视频风格,仅
sora_video2 等支持的模型可用。可选值包括 thanksgiving(感恩节)、comic(漫画)、news(新闻)、selfie(自拍)、nostalgic(复古)、anime(动漫)。是否使用故事板,以实现更精细的视频生成细节控制。
Response
任务 ID,后续查询时作为
id 参数传入。任务状态,常见值包括
pending、queued、processing、completed、failed、cancelled。状态最近更新时间(Unix 时间戳)。
对象类型,部分响应为
video。实际使用的模型名。
任务进度。
提交详情,通常包含回显的
input 字段。