创建生成视频任务

​

(Veo Image-to-Video)

​

快速开始

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

​

📌 基础信息

• 接口地址: 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)

{
  "id": "task_MQKsdsosLYRreob4Z4NzTFxZKtSoVRWZ",
  "task_id": "task_MQKsdsosLYRreob4Z4NzTFxZKtSoVRWZ",
  "object": "video",
  "model": "veo-2.0-generate-001",
  "status": "queued",
  "progress": 0,
  "created_at": 1775116001
}

​

📝 请求示例

{
  "model": "Veoq3-turbo",
  "prompt": "Contemporary dance, the people in the picture are performing contemporary dance.",
  "images": ["https://example.com/dance_start_frame.png"],
  "duration": 7
}

​

💡 开发者建议

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