vidu接口批量生成视频需按模式区分参数:文生视频必填prompt、video_length_seconds、resolution;图生视频需提供first_frame_url等图像字段;通用参数如aspect_ratio、seed、model、motion_intensity为可选但有约束。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要调用Vidu接口批量生成视频,但不清楚不同生成模式下参数该怎么组织、哪些字段必须填、哪些能省略,稍有偏差就返回400错误或任务被拒。
文生视频(text-to-video)接口参数写法
该模式仅依赖文本提示词驱动生成,适用于无实图、概念化强或需快速迭代脚本的场景。
第一步:确认请求地址为 https://api.vidu.com/v1/generate,不是旧版 /v1/tasks/submit。
第二步:构造 JSON 请求体,核心字段必须包含 prompt、video_length_seconds、resolution 三项,缺一不可。例如:
{"prompt":"一只橘猫蹲在窗台晒太阳,尾巴轻摆,窗外梧桐叶影摇曳","video_length_seconds":8,"resolution":"1080p"}
注意:prompt 字符数不能超过 2000;video_length_seconds 只接受整数,可选值为 4、8、12、16;resolution 必须严格写成 "540p"、"720p"、"1080p" 或 "4K",写成 "1080P" 或 "1080" 会报错。
第三步:若需控制风格,添加 style 字段,值为字符串,如 "anime"、"realistic"、"cinematic";不填则走默认通用风格。
图生视频(image-to-video)接口参数写法
当你已有首帧图(或首尾帧),希望保持主体一致性并生成动态画面时,必须使用 image_url 或 base64 图片字段。
方法一:单图驱动(首帧锁定)
提交时必须携带 input.first_frame_url 字段,值为公网可访问的图片 URL(HTTPS 开头);若用 Base64,则格式为 data:image/jpeg;base64,/...(注意逗号不可遗漏)。
Vidu视频生成插件(viduq3-pro、viduq3-turbo、viduq2、viduq1)。支持文字转视频、图片转视频、参考转视频以及起始编辑。
方法二:首尾帧插值(start-end2video)
需同时提供 input.first_frame_url 和 input.last_frame_url,二者格式一致;【两个 URL 必须可被服务器直接 GET 访问,本地 file:// 路径或内网地址一律失败】。
方法三:多图参考(最多 7 张)
使用 input.reference_images 数组,每个元素为带 url 或 base64 的对象,例如 [{"url":"https://...1.jpg"},{"url":"https://...2.png"}];系统按上传顺序自动分配角色锚点,无需额外标注。
视频生成通用参数配置说明
所有模式都支持以下可选参数,但作用域不同:
aspect_ratio:字符串,仅限 "16:9"、"9:16"、"1:1";设为 "9:16" 时,【必须同步指定 output_resolution 为 "1080x1920" 或 "720x1280",否则服务端将降级为 16:9 输出】。
seed:整数,设为 0 表示随机,设为固定值(如 42)可复现相同结果;调试阶段建议固定 seed。
model:字符串,影响效果与速度;Q1 专用于动漫,viduq2-pro 适合高细节写实,viduq2-turbo 平衡快与质;不传则走平台默认模型,但默认值可能随版本变更。
parameters.motion_intensity:浮点数 0.0–1.0,控制动作幅度;开箱类视频建议 0.3–0.5,舞蹈类可设 0.7–0.9;值过高易导致肢体扭曲或物理失真。










