注意:
##所有接口均需要使用Bearer Token进行认证##
获取 API Key :
访问 API Key 管理页面 获取您的 API Key
使用时在请求头中添加:
Authorization: Bearer YOUR_API_KEY视频生成模型名称
"sora-2-pro"
提示词,描述想要生成什么样的视频,限制为5000token
5000"A cat playing piano"
视频宽高比,16:9会生成横屏视频,9:16会生成竖屏视频
16:9, 9:16 "16:9"
规定生成视频的时长(秒),默认为15,表示15秒
说明:
15、25两个值,分别代表15秒、25秒duration的值进行扣费,秒数越高价格越高15
视频质量
说明:
standard: 标准质量,标准价格high: 高质量,价格会提升duration为15时仅支持high质量,duration为25时仅支持standard质量standard, high "standard"
参考图像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-pro"
任务的具体类型
video.generation.task 任务进度百分比 (0-100)
0 <= x <= 1000
任务状态
pending, processing, completed, failed "pending"
视频任务详细信息
任务的输出类型
text, image, audio, video "video"
使用量和计费信息