Vidu文生视频API
更新时间 2026-10-10 18:30:17
最近更新时间: 2026-10-10 18:30:17
本文介绍Vidu Q3系列文生视频调用API。
模型简介
Vidu Q3 系列文生视频模型，包含 viduq3‑turbo、viduq3‑pro 两个版本，支持音视频直出能力，最高支持 16 秒视频生成，支持多比例、多分辨率输出。
支持的模型
| 模型 | 说明 |
|---|---|
| viduq3‑turbo | 生成速度更快，兼顾视频效果与产出效率 |
| viduq3‑pro | 画质表现更优，视频画面生动立体，细节表现力强 |
调用流程
接口采用异步任务模式，分两步执行：
step1：调用创建任务接口，成功返回task_id
step2：调用查询任务接口查询对应task_id，直到state值为success，获取生成视频url
创建任务接口详情
http调用
请求方式：POST
请求路径：https://ai.ctaigw.cn/v1/text2video
请求头
| 参数 | 必填 | 说明 |
|---|---|---|
| Content‑Type | 是 | 固定application/json |
| Authorization | 是 | Token ${YOUR_APP_KEY} |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型调用名称或模型 ID |
| prompt | string | 是 | 文本提示词，用于描述视频内容；最大 5000 字符 |
| duration | integer | 否 | 视频时长； 默认 5 秒，取值范围 1‑16 |
| seed | integer | 否 | 随机种子； 不传 / 传 0 使用随机种子，自定义可复现生成结果 |
| aspect_ratio | string | 否 | 视频画幅比例；默认16:9； 取值范围：16:9、9:16、3:4、4:3、1:1 |
| resolution | string | 否 | 视频分辨率；默认 720p； 取值范围：540p、720p、1080p |
| audio | bool | 否 | 是否使用音视频直出能力，默认为true，枚举值为： - false：不需要音视频直出，输出静音视频 - true：需要音画同步，输出声音的视频（包括台词和音效） |
| payload | string | 否 | 透传参数 不做任何处理，仅数据传输 注：最多 1048576个字符 |
| watermark | bool | 否 | 是否添加水印； true 添加，false 不添加；默认 false |
| wm_position | integer | 否 | 水印位置；默认 3 取值范围：1 左上、2 右上、3 右下、4 左下； |
| wm_url | string | 否 | 自定义水印图片 URL； 不传使用平台默认水印 |
| meta_data | string | 否 | JSON 字符串格式元数据透传，业务自定义标签 |
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| task_id | string | 任务唯一 ID，用于轮询查询任务结果 |
| state | string | 处理状态 取值范围： created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败 |
| model | string | 调用模型名称 |
| prompt | string | 请求传入提示词 |
| duration | integer | 视频时长 |
| seed | integer | 随机种子 |
| resolution | string | 输出分辨率 |
| payload | string | 透传参数 |
| watermark | bool | 是否开启水印 |
| created_at | string | 任务创建 UTC 时间 |
请求/响应示例
请求
curl -X POST https://ai.ctaigw.cn/v1/text2video \
-H "Authorization: Token {YOUR_APP_KEY}" \
-H "Content-Type: application/json" \
-d '{
"model": "viduq3-pro",
"prompt": "超写实，宇航员身穿宇航服行走在迷雾之中，背景闪烁白色金色光芒，宏大全景画面",
"duration": 8,
"seed": 0,
"aspect_ratio": "16:9",
"resolution": "720p",
"watermark": false
}'响应
{
"task_id": "your_task_id_here",
"state": "created",
"model": "viduq3-pro",
"prompt": "超写实，宇航员身穿宇航服行走在迷雾之中，背景闪烁白色金色光芒，宏大全景画面",
"duration": 8,
"seed": 123456,
"aspect_ratio": "16:9",
"resolution": "720p",
"payload": "",
"watermark": false,
"created_at": "2026-09-06T10:20:30.123456Z"
}
