创建图生视频任务

​

(Vidu Image-to-Video)

​

快速开始

1. 提交任务 → 获得 task_id
2. 轮询状态 → 等待 status 变为 completed 返回公网链接

​

📌 基础信息

• 接口地址: POST /v1/video/generations
• 认证方式: Bearer Token (Authorization: Bearer {{YOUR_API_KEY}})
• 内容类型: application/json

​

📥 请求参数 (Request Body)

​

🖼️ 图片规格要求

• 格式: PNG, JPEG, JPG, WebP。
• 大小: 图片文件不超过 50MB（POST Body 限制 20MB）。
• 比例: 图片长宽比需在 1:4 到 4:1 之间。

​

📤 响应结果 (Response)

​

📝 请求示例

{
"model": "viduq3-turbo",
"prompt": "Contemporary dance, the people in the picture are performing contemporary dance.",
"images": [
"https://example.com/dance_start_frame.png"
],
"duration": 7,
"metadata": {
"audio": true,
"audio_type": "all",
"callback_url": "https://your-api.com/callback/vidu-i2v",
"off_peak": false
}
}

​

💡 开发者建议

1. 音频拆分: 仅在 Q2、Q1 模型下支持 audio_type 的精细拆分（如仅保留音效或仅保留人声）。
2. 错峰任务管理: 错峰模式任务如果 48 小时内未完成会自动取消并返还积分，您也可以在任务处理前手动取消。
3. 提示词推荐: 如果您对描述词没有把握，可以开启 is_rec: true，系统会自动优化并生成效果更好的视频。
4. 回调签名: Vidu 推送回调时采用签名算法，建议在服务端进行验签以保证安全性。