Vidu视频生成API调用过程

必须通过标准HTTP POST请求调用Vidu API触发视频生成，需包含合法API Key（仅限中国内地北京地域）、正确Endpoint、完整JSON请求体及异步轮询机制，缺一不可。

您需要通过标准HTTP POST请求向Vidu服务端提交结构化参数，才能触发视频生成任务，而不是在网页界面点击“生成”按钮就完成。API调用必须包含合法认证、正确地域Endpoint、完整JSON请求体及异步结果轮询机制，缺一不可。

获取API Key与确认地域绑定

登录Vidu控制台后，必须在“中国内地(北京)”地域下创建API Key，其他地域的密钥无法调用Vidu服务，跨地域请求将直接返回403错误。

第一步：访问https://www.php.cn/link/39eee5d086ad67250179d9be1a436c07，使用已通过Beta审核的账号登录。

第二步：在“API密钥管理”页面，【务必选择地域为中国内地(北京)】，点击“创建密钥”，生成并复制新Key。

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

构造并发送POST请求

请求必须发往北京地域专属Endpoint，Header中携带Bearer令牌，Body为JSON格式，字段缺失或类型错误会导致400响应。

方法一：curl命令行直调（适合调试）
执行以下命令，替换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"}'

方法二：Python脚本调用（推荐生产环境）
安装依赖：pip install requests

运行脚本时，【必须确保requests.post()的url、headers、json data三者全部匹配北京地域配置】，任一错配即失败。

轮询获取生成结果

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才有效。