首先，地域必须切换为中国内地（北京），并且使用合法的API Key；请求体中的model字段要严格填写"vidu-v1"，parameters必须包含duration、width、height、aspect_ratio，prompt不能超过256字符且不能有风格冲突。

很多人在使用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、input、parameters。其中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中混用“赛璐璐着色”和“胶片颗粒感”、“厚涂风”和“写实皮肤纹理”这类语义冲突的词，否则模型会陷入逻辑矛盾，最终输出黑帧。