要调用Vidu API生成1080P视频,须绑定北京地域、获取对应API Key、构造精准认证头并提交规范JSON请求体——跨地域返回403,Authorization空格错误触发401;开通服务需在百炼控制台切换至北京地域创建密钥;认证支持Bearer(Bearer后仅一个半角空格)或HMAC签名;图生视频接口返回task_id,需轮询查询结果,video_url有效期7天。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让自己的应用调用Vidu API生成1080P视频,必须先完成地域绑定、获取合法API Key、构造带时间戳的认证头,再提交符合字段规范的JSON请求体——跨地域调用直接返回403,Authorization头多一个空格或少一个空格都会触发401错误。
开通服务并获取北京地域API Key
Vidu API当前仅支持中国内地(北京)地域调用,模型、Endpoint与API Key三者必须严格同属该地域,否则所有请求均被拦截。
第一步:登录阿里云百炼控制台,进入“大模型服务平台百炼”。
第二步:在搜索栏输入vidu,定位到Vidu模型卡片,点击“立即开通”,勾选协议并完成授权。
第三步:进入“API密钥管理”,【务必手动切换地域为中国内地(北京)】,点击“创建密钥”,复制生成的sk-开头的API Key——此Key不可用于上海或新加坡地域Endpoint。
配置认证请求头与时间戳
Bearer Token认证对格式极其敏感,任何空格、大小写偏差或时间偏移超20分钟都会导致鉴权失败。
方法一:直接使用Bearer认证(适用于基础调用)
设置请求头Authorization值为Bearer sk-xxxxx,注意Bearer后【有且仅有一个英文半角空格】,之后紧跟API Key,中间不得换行、不得加引号、不得含中文空格。
方法二:启用vivo风格HMAC签名(适用于高安全要求场景)
拼接待签名字符串:method + access_key + timestamp + v,其中timestamp须为毫秒级整数;用密钥计算HMAC-SHA256,将结果Base64编码后填入sign参数;同时在请求头中添加X-Vidu-Timestamp与X-Vidu-Signature字段。
Vidu视频生成插件(viduq3-pro、viduq3-turbo、viduq2、viduq1)。支持文字转视频、图片转视频、参考转视频以及起始编辑。
发起图生视频异步任务
图生视频接口不返回视频文件,只返回task_id,后续需轮询查询结果;同一组参数重复提交会复用已有task_id,不会新建任务。
1. 向北京Endpoint发送POST请求:
https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
2. 请求体必须为JSON格式,包含以下三个核心字段:
• model:固定填"vidu-v1"
• input:对象内含image_url(公网可直访的PNG/JPG URL,需HTTPS)和prompt(中文提示词,建议≤50字)
• parameters:至少指定aspect_ratio(如"16:9"或"9:16")和seed(建议填随机整数避免重复)
3. 成功响应状态码为200,返回体中提取task_id字段,该ID有效期24小时,可用于后续轮询。
轮询获取生成结果
任务状态非即时完成,需主动轮询;轮询间隔建议≥2秒,过于频繁将触发429限流。
向https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}发起GET请求,携带相同Authorization头。
当返回JSON中status字段变为"succeeded"时,从output.video_url字段提取直链URL——该链接7天内有效,下载即得无水印MP4文件。

















