使用时在请求头中添加:
Authorization: Bearer YOUR_API_KEY
Sora-2 Preview 模型,用于视频生成
sora-2-preview "sora-2-preview"
提示词,描述想要生成的视频,限制为2000token
2000"A cat playing in the grass"
参考图片URL,用于图生视频
"https://example.com/image.png"
视频时长(秒)
5
生成视频的宽高比,默认值为 auto
auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 模型扩展参数
任务完成后的HTTPS回调地址
回调时机:
安全限制:
2048 字符回调机制:
10 秒3 次(会分别在失败的 1 秒/2 秒/4 秒后进行重试)"https://your-domain.com/webhooks/video-task-completed"
视频生成任务创建成功
任务创建时间戳
1757165031
任务ID
"task-unified-1757165031-uyujaw3d"
实际使用的模型名称
任务的具体类型
video.generation.task 任务进度百分比 (0-100)
0 <= x <= 1000
任务状态
pending, processing, completed, failed "pending"
异步任务信息
任务的输出类型
text, image, audio, video "video"