要成功调用vidu api,必须先完成北京地域专属api key获取与bearer token认证:需在阿里云百炼控制台严格选择“中国内地(北京)”地域创建sk-开头的52位密钥,构造authorization: bearer sk-xxx请求头(注意空格),确保timestamp与服务器偏差≤300秒,否则返回401或403错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让自己的应用成功调用Vidu API生成视频,第一步必须通过鉴权校验,否则所有请求都会返回401或403错误;API Key不匹配地域、timestamp偏差超300秒、签名算法错误,任一条件不满足都将导致认证失败。
获取北京地域专属API Key
Vidu API当前【仅支持中国内地(北京)地域】,跨地域生成的API Key与Endpoint无法互通,硬要混用会直接返回403 Forbidden且无调试提示。
登录阿里云百炼控制台 → 进入“大模型服务平台百炼” → 搜索栏输入vidu → 找到Vidu模型卡片 → 点击“立即开通”并完成服务授权 → 进入“API密钥管理”页面 → 严格选择地域为“中国内地(北京)” → 创建新密钥 → 复制生成的API Key(以sk-开头,共52位字符)。
这一步不能跳过地域筛选——哪怕你账号默认地域是上海,也必须手动切换至北京再创建密钥,否则后续所有请求都会被拦截。
构造Bearer Token认证头
方法一:直接拼接Authorization头
在HTTP请求头中添加:Authorization: Bearer sk-xxx,其中sk-xxx替换为你复制的API Key。注意Bearer与Key之间有一个空格,少一个空格就会报错401。
方法二:使用环境变量安全传参(推荐)
将API Key存入系统环境变量DASHSCOPE_API_KEY,代码中读取后动态注入请求头。Java示例:headers.put("Authorization", "Bearer " + System.getenv("DASHSCOPE_API_KEY"))。这样避免密钥硬编码进源码,防止Git泄露。
Vidu视频生成插件(viduq3-pro、viduq3-turbo、viduq2、viduq1)。支持文字转视频、图片转视频、参考转视频以及起始编辑。
【timestamp必须精确到秒且与服务器时间偏差≤300秒】,Vidu服务端会校验该字段,本地时间若未同步将导致签名无效;建议调用前执行ntpdate -s time.windows.com或启用系统自动时间同步。
验证鉴权是否生效
第一步:用Postman或curl发起最简测试请求
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
Headers含:Content-Type: application/json 和 Authorization: Bearer sk-xxx
Body填最小合法JSON:{"prompt":"测试","video_length_seconds":4,"resolution":"720p"}
第二步:观察响应状态码
返回200且含task_id字段,说明鉴权通过;返回401表示Token格式错误或Key无效;返回403大概率是地域不匹配或API Key未开通服务;返回429说明初始积分已用尽。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










