输入关键词搜索

文本生成视频

更新时间: 2026/08/27 10:13:38

该接口可以根据文本提示词生成视频。

请求信息

请求 URL

POST /hub/vidu/v2/text2video

请求头

Header 必填 示例值
Authorization 是 Bearer sk-xxxxx
Content-Type 是 application/json; charset=utf-8

请求体

字段 类型 必填 说明
model string 是 模型名称。常见可选值:viduq3-turbo、viduq3-pro、viduq2、viduq1。其中 viduq3-turbo 生成更快,viduq3-pro 质量更高
style string 否 风格,默认 general。可选值:general、anime。q2、q3 系列模型下该参数通常不生效
prompt string 是 文本提示词,最长 5000 字符
duration int 否 视频时长。viduq3-pro、viduq3-turbo 默认 5 秒,可选 1-16;viduq2 默认 5 秒,可选 1-10;viduq1 默认 5 秒,通常仅支持 5
seed int 否 随机种子。传 0 或不传时自动生成
aspect_ratio string 否 画面比例,默认 16:9。常见可选值:16:9、9:16、3:4、4:3、1:1。其中 3:4、4:3 通常仅 q2、q3 系列支持
resolution string 否 输出分辨率。默认值与模型和时长有关,常见可选值:540p、720p、1080p
movement_amplitude string 否 运动幅度,默认 auto。可选值:auto、small、medium、large。q2、q3 系列模型下通常不生效
bgm bool 否 是否添加背景音乐,默认 false。q3 系列模型下通常不生效;q2 模型在 9 秒或 10 秒时通常不生效
audio bool 否 是否启用音视频直出。默认通常为 true,仅 q3 系列模型支持
payload string 否 透传字段,最长 1048576 字符
off_peak bool 否 是否启用错峰模式,默认 false
watermark bool 否 是否添加水印,默认通常不添加
wm_position int 否 水印位置。可选值:1 左上、2 右上、3 右下、4 左下;默认 3
wm_url string 否 自定义水印图片地址。不传时使用默认水印
meta_data string 否 元数据标识,JSON 字符串,透传使用
callback_url string 否 任务状态回调地址,具体规范请参考 。

请求示例

httpPOST /hub/vidu/v2/text2video
Authorization: Bearer sk-xxxxx
Content-Type: application/json; charset=utf-8
json{
  "model": "viduq3-pro",
  "style": "general",
  "prompt": "一名宇航员在薄雾中缓慢前行,镜头从中景推进到近景,背景有金色灯光闪烁。",
  "duration": 5,
  "seed": 0,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "movement_amplitude": "auto",
  "off_peak": false
}

响应信息

响应体

字段 类型 说明
task_id string 任务 ID
state string 任务状态。常见值:created、queueing、processing、success、failed
model string 本次调用使用的模型
style string 本次调用使用的风格
prompt string 本次调用的提示词
duration int 本次调用的视频时长
seed int 本次调用的随机种子
aspect_ratio string 本次调用的画面比例
resolution string 本次调用的分辨率
movement_amplitude string 本次调用的运动幅度
payload string 本次调用传入的透传字段
off_peak bool 本次调用是否启用错峰
watermark bool 本次调用是否启用水印
credits string 消耗量
created_at string 创建时间

响应示例

json{
  "task_id": "tsk_1234567890",
  "state": "created",
  "model": "viduq3-pro",
  "style": "general",
  "prompt": "一名宇航员在薄雾中缓慢前行,镜头从中景推进到近景,背景有金色灯光闪烁。",
  "duration": 5,
  "seed": 24681357,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "movement_amplitude": "auto",
  "payload": "",
  "off_peak": false,
  "watermark": false,
  "credits": "12.500000",
  "created_at": "2026-04-16T09:30:00Z"
}

错误码

完整列表请参考客户端 API 错误码。

此文档是否对你有帮助?
有帮助
去反馈
  • 请求信息
  • 请求 URL
  • 请求头
  • 请求体
  • 请求示例
  • 响应信息
  • 响应体
  • 响应示例
  • 错误码