GlobalAiOpc
Vidu - 创建任务
使用 Vidu 模型创建视频生成任务，支持图生视频和首尾帧引导
Vidu 创建视频任务
使用 Vidu 的 AI 模型创建视频生成任务，支持文生视频、图生视频和首尾帧引导模式。
认证
获取 Key所有请求都需要在请求头中包含 Bearer token：
cURL
Authorization: Bearer {{key}}
基础 URL
https://zcbservice.aizfw.cn/kyyReactApiServerbaseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址，请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。模型介绍
支持的模型：
viduq3-pro：高效生成优质音视频内容，让视频内容更生动、更形象、更立体，效果更好viduq3-turbo：对比 viduq3-pro，生成速度更快
请求参数
modelstring必填模型名称
可选值：
viduq3-pro- Vidu Q3 Pro，效果好viduq3-turbo- Vidu Q3 Turbo，速度快
promptstring必填视频生成提示词，描述所需的视频内容
示例：
"A cat dancing in the rain, cinematic style"durationnumber视频时长（秒），默认值依据模型而定
- viduq3-pro、viduq3-turbo: 默认 5 秒
- 可选范围：1-16 秒
aspect_ratiostring输出视频比例，默认为
16:9支持的值：
16:9- 横屏9:16- 竖屏1:1- 正方形4:3- 标准屏3:4- 竖屏标准
resolutionstring输出分辨率，默认为
720p支持的值：
540p- 标清720p- 高清（默认）1080p- 全高清
图生视频模式
first_imagestring首帧图 URL（图生视频场景）
使用方式：
- 单独使用：图生视频场景
- 搭配 last_image：首尾帧场景
格式要求：jpeg、png、webp 值类型：公网 URL
last_imagestring尾帧图 URL（首尾帧场景，必须搭配 first_image 使用）
格式要求：jpeg、png、webp 值类型：公网 URL
必须与
first_image 一起使用响应参数
idstring视频生成任务的唯一标识符，用于后续查询任务状态
objectstring对象类型，固定为
videocreatedinteger任务创建时间戳
modelstring使用的模型名称
statusstring任务状态：
queued- 排队中processing- 处理中completed- 已完成failed- 失败
errorstring错误信息，当 status 为
failed 时返回使用场景
文生视频
仅使用 prompt 生成视频，无需图片引导
图生视频
使用 first_image 作为首帧，生成连贯视频
首尾帧引导
同时使用 first_image 和 last_image，精确控制开始和结束
Vidu 特性
灵活时长
支持 1-16 秒可调节视频时长
多比例支持
支持 5 种常用视频比例
多分辨率
支持 540p、720p、1080p 三种分辨率
双模型选择
Pro 版效果更好，Turbo 版速度更快
最佳实践：
- 视频生成为异步处理，需要通过返回的
id查询任务状态和结果 - 在提示词中明确描述所需的视觉效果和风格
- 选择合适的模型：
- viduq3-pro：高效生成优质音视频内容，效果更好
- viduq3-turbo：生成速度更快
- 根据需求选择合适的时长（1-16秒）
- 图片 URL 必须是公网可访问的地址
场景选择建议：
- 文生视频：完全由 AI 创作，适合创意探索
- 图生视频：基于首帧图片生成，适合有明确起始画面的场景
- 首尾帧引导：精确控制开始和结束，适合需要特定转场效果的场景