注意:
##所有接口均需要使用Bearer Token进行认证##
获取 API Key :
访问 API Key 管理页面 获取您的 API Key
使用时在请求头中添加:
Authorization: Bearer YOUR_API_KEY视频生成模型名称
"sora-2"
提示词,描述想要生成什么样的视频,限制为5000token
5000"A cat playing piano"
视频宽高比,16:9会生成横屏视频,9:16会生成竖屏视频
16:9, 9:16 "16:9"
规定生成视频的时长(秒),默认为10,表示10秒
说明:
10、15两个值,分别代表10秒、15秒duration的值进行扣费,15秒的价格相比10秒会提升10
参考图像URL列表,用于图生视频功能
注意:
1张10MB.jpg、.jpeg、.png、.webp.png、.jpg)1["http://example.com/image1.jpg"]是否去除视频水印,默认会进行去除
说明:
true: 去除水印,价格会提升,此为默认值,请在发送请求时注意false: 保留水印,标准价格true
任务完成后的HTTPS回调地址
回调时机:
安全限制:
2048字符回调机制:
10秒3次(会分别在失败的1秒/2秒/4秒后进行重试)"https://your-domain.com/webhooks/video-task-completed"
视频生成任务创建成功
任务创建时间戳
1757169743
任务ID
"task-unified-1757169743-7cvnl5zw"
实际使用的模型名称
"sora-2"
任务的具体类型
video.generation.task 任务进度百分比 (0-100)
0 <= x <= 1000
任务状态
pending, processing, completed, failed "pending"
视频任务详细信息
任务的输出类型
text, image, audio, video "video"
使用量和计费信息