Vidu视频生成API调用流程

调用Vidu API生成视频，不是点个按钮那么简单——你必须通过标准HTTP POST请求向服务端提交结构化参数，带上合法认证、正确地域的Endpoint、完整的JSON请求体，还得配合异步轮询机制，一个都不能少。下面把整个流程拆开来讲清楚。

获取API Key与确认地域绑定

登录Vidu控制台后，记得一定要在“中国内地（北京）”地域下创建API Key。其他地域的密钥是调不通的，跨地域请求会直接返回403错误。具体操作分三步：

第一步：访问Vidu控制台，用已通过Beta审核的账号登录。

第二步：在“API密钥管理”页面，

，点击“创建密钥”，生成并复制新Key。

第三步：进入阿里云百炼控制台，搜索“Vidu”，确认模型卡片已开通，且开通地域与API Key地域严格一致。

构造并发送POST请求

请求必须发往北京地域专属的Endpoint，Header里带上Bearer令牌，Body是JSON格式。字段缺失或类型错误，会收到400响应。两种常用方式：

执行以下命令，记得把 YOUR_API_KEY_HERE 和 prompt 换成你自己的：

curl -X POST "https://api.vidu.studio/v1/video/generate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "X-Vidu-Quantity: 1" \
  -d '{"prompt":"一只橘猫在窗台晒太阳，阳光透过纱帘洒在毛尖上","duration":4,"resolution":"1080P","model_version":"q3"}'

先安装依赖：pip install requests
然后运行脚本，注意，任一错配都会失败。

轮询获取生成结果

Vidu API是异步模式——POST成功只返回一个 task_id，视频不会立刻生成。你需要主动轮询状态，直到完成。具体流程：

① 从上一步响应JSON中提取 task_id 字段值；

② 向 https://api.vidu.studio/v1/video/task/{task_id} 发起GET请求，Header携带相同的Authorization；

③ 检查响应中 status 字段：如果为 processing，等待2秒后重试；如果为 success，提取 video_url 下载MP4；如果为 failed，读取 error_message 定位原因。

这一步不能跳过——直接访问 video_url 会返回404，必须等 status 变更为 success 才有效。