创建视频
POST
/v1/videos
概述
videos 是 OpenAI Sora 的视频生成接口，通过文本提示词或可选的参考图像输入创建视频生成任务。任务生成完成后方可进行后续混编、下载等操作
关于Sora生成接口的更多信息，建议参考OpenAI 官方文档
重要说明
视频生成需要较长时间，接口采用异步模式。创建任务后会立即返回任务 ID，需要通过查询接口获取生成进度和结果。
生成的视频内容必须遵守 OpenAI 的使用政策，不得生成违规、暴力、色情或侵犯版权的内容。
最佳实践
常见问题
A: 通常需要几分钟到十几分钟不等，具体时间取决于视频时长、分辨率和服务器负载。若出现长时间未响应或失败请联系客服
A: 默认支持
720x1280，具体支持的分辨率请参考模型文档。A: 默认 4 秒，最大时长取决于模型限制，请参考官方文档。
A: 使用详细的提示词、选择适当的时长、提供高质量的参考图像。
请求参数
Header 参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1/videos' \
--header 'Authorization: {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"prompt": "cat", // 必需。用于生成视频的文本提示
"model": "sora-2", // 可选。要使用的视频生成模型, 默认为 sora-2。枚举值: sora-2-pro, sora-2
"seconds": "4", // 可选。剪辑时长（秒）, 默认值为 4 秒。枚举值: 4, 8, 12
"size": "720x1280", // 可选。输出分辨率格式为宽 x 高, 默认值为 720×1280。枚举值: 720x1280, 1280x720, 1024x1792, 1792x1024
"input_reference": "/path/to/your/image", // 可选。图像参考, 用于指导生成。仅本地路径上传, 不支持url, 且至多上传一张图片。curl 请求参数请添加--form '\''input_reference=@"/path/to/your/image"'\''。上传图像尺寸需等同于size
}'响应示例响应示例
{
"id": "vid_abc123def456ghi789jkl012mno345pqr",
"object": "video",
"created_at": 1732320000,
"status": "in_progress",
"completed_at": null,
"error": null,
"expires_at": null,
"model": "sora-2-pro",
"progress": 50,
"remixed_from_video_id": null,
"seconds": "8",
"size": "1280x720"
}