跳转到主要内容
POST
/
kyyReactApiServer
/
v1
/
vidu
/
videos
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/vidu/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3-pro",
    "prompt": "A cat dancing in the rain, cinematic style",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "1080p"
  }'
{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "viduq3-pro",
  "status": "queued",
  "error": null
}

Vidu 创建视频任务

使用 Vidu 的 AI 模型创建视频生成任务,支持文生视频、图生视频和首尾帧引导模式。

认证

所有请求都需要在请求头中包含 Bearer token:
Authorization: Bearer {{key}}

模型介绍

支持的模型:
  • viduq3-pro:高效生成优质音视频内容,让视频内容更生动、更形象、更立体,效果更好
  • viduq3-turbo:对比 viduq3-pro,生成速度更快

请求参数

model
string
必填
模型名称可选值:
  • viduq3-pro - Vidu Q3 Pro,效果好
  • viduq3-turbo - Vidu Q3 Turbo,速度快
prompt
string
必填
视频生成提示词,描述所需的视频内容示例:"A cat dancing in the rain, cinematic style"
duration
number
视频时长(秒),默认值依据模型而定
  • viduq3-pro、viduq3-turbo: 默认 5 秒
  • 可选范围:1-16 秒
aspect_ratio
string
输出视频比例,默认为 16:9支持的值:
  • 16:9 - 横屏
  • 9:16 - 竖屏
  • 1:1 - 正方形
  • 4:3 - 标准屏
  • 3:4 - 竖屏标准
resolution
string
输出分辨率,默认为 720p支持的值:
  • 540p - 标清
  • 720p - 高清(默认)
  • 1080p - 全高清

图生视频模式

first_image
string
首帧图 URL(图生视频场景)使用方式:
  • 单独使用:图生视频场景
  • 搭配 last_image:首尾帧场景
格式要求:jpeg、png、webp 值类型:公网 URL
last_image
string
尾帧图 URL(首尾帧场景,必须搭配 first_image 使用)格式要求:jpeg、png、webp 值类型:公网 URL
必须与 first_image 一起使用

响应参数

id
string
视频生成任务的唯一标识符,用于后续查询任务状态
object
string
对象类型,固定为 video
created
integer
任务创建时间戳
model
string
使用的模型名称
status
string
任务状态:
  • queued - 排队中
  • processing - 处理中
  • completed - 已完成
  • failed - 失败
error
string
错误信息,当 status 为 failed 时返回

使用场景

文生视频

仅使用 prompt 生成视频,无需图片引导

图生视频

使用 first_image 作为首帧,生成连贯视频

首尾帧引导

同时使用 first_image 和 last_image,精确控制开始和结束

Vidu 特性

灵活时长

支持 1-16 秒可调节视频时长

多比例支持

支持 5 种常用视频比例

多分辨率

支持 540p、720p、1080p 三种分辨率

双模型选择

Pro 版效果更好,Turbo 版速度更快
最佳实践:
  1. 视频生成为异步处理,需要通过返回的 id 查询任务状态和结果
  2. 在提示词中明确描述所需的视觉效果和风格
  3. 选择合适的模型:
    • viduq3-pro:高效生成优质音视频内容,效果更好
    • viduq3-turbo:生成速度更快
  4. 根据需求选择合适的时长(1-16秒)
  5. 图片 URL 必须是公网可访问的地址
场景选择建议:
  • 文生视频:完全由 AI 创作,适合创意探索
  • 图生视频:基于首帧图片生成,适合有明确起始画面的场景
  • 首尾帧引导:精确控制开始和结束,适合需要特定转场效果的场景
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/vidu/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3-pro",
    "prompt": "A cat dancing in the rain, cinematic style",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "1080p"
  }'
{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "viduq3-pro",
  "status": "queued",
  "error": null
}