必须将地域切换为中国内地(北京)并使用合法API Key,请求体中model字段严格为"vidu-v1",parameters含duration、width、height、aspect_ratio,prompt不超过256字符且无风格冲突。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要通过Vidu API发起文生视频请求却卡在参数报错或返回空白帧,问题往往出在JSON结构缺失关键字段、时间戳格式错误、或模型名拼写不一致——跨地域调用直接403,model字段填错成"vidu-1.5"或"Q2"将导致422错误。
确认基础认证与地域前提
第一步:登录阿里云百炼控制台→进入“大模型服务平台百炼”→搜索“vidu”→点击“立即开通”并完成授权;【必须手动将控制台右上角地域切换为中国内地(北京)】,否则后续所有API请求均被拦截。
第二步:进入“API密钥管理”,创建新密钥,复制生成的sk-开头API Key;该Key仅在北京地域Endpoint下有效,不可用于上海或新加坡节点。
第三步:构造Authorization请求头,格式为Bearer + 半角空格 + API Key;注意Bearer后有且仅有一个英文半角空格,多一个少一个都会触发401错误。
构建合法JSON请求体
向北京专属Endpoint发送POST请求:
https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/text-to-video
请求体必须为标准JSON,含且仅含以下三个顶层字段:
• model:严格填写"vidu-v1"(不是"vidu-1.5""Q1""Q2");
• input:对象结构,内含prompt字段,值为纯中文提示词(例:"一只银渐层猫跃上窗台,尾巴轻摆,窗外梧桐叶沙沙晃动,柔光漫射,8K超清质感");
• parameters:对象结构,必须包含duration(单位秒,支持4/6/8/12/15/18)、width(建议1080)、height(竖屏填1920,横屏填1080)、aspect_ratio(填"9:16"或"16:9")。
注意:parameters中不可出现"style""motion_intensity"等网页版参数,API不识别;若添加将导致422校验失败。
规避常见参数陷阱
方法一:时长与分辨率强绑定
duration=4时,width×height只能为1080×1920(9:16)或1920×1080(16:9);若设duration=15但width=720,则返回400错误。
方法二:prompt长度硬限制
单次请求prompt字符数不得超过256;超长会被截断,导致主体丢失——例如输入300字产品介绍,AI只读前256字,后半句功能描述消失。
方法三:禁用冲突性风格词
避免在prompt中混用“赛璐璐着色”与“胶片颗粒感”、“厚涂风”与“写实皮肤纹理”,语义冲突将使模型陷入逻辑矛盾而输出黑帧。


















