Vidu 文生视频

提交纯文本生成视频任务。

POST /vidu/ent/v2/text2video

当前可用模型

模型	说明
	高效生成优质音视频内容
	最新模型
	画面清晰，平滑转场，运镜稳定

请求头

名称	类型	必填	说明
	string	是	请求身份认证。使用 Bearer Token，示例值：。
	string	是	请求内容类型，必须设置为 。

请求体

名称	类型	必填	说明
	string	是	模型名称，可选值见上方「当前可用模型」。
	string	否	风格。:通用风格;:动漫风格。注:使用 q2、q3 模型时该参数不生效。
	string	是	文本提示词。生成视频的文本描述,支持中文和英文。
	integer	否	视频时长(秒)。:默认 5 秒,可选 1-10 秒;其他模型按默认值。
	integer	否	随机种子。不传或传 0 时使用随机数,手动设置则使用指定种子。
	string	否	画幅比例。可选值:(默认)、、、、。注:、 仅支持 q2、q3 模型。
	string	否	分辨率。默认值依据模型和视频时长而定。(1-10 秒):默认 720p,可选 540p、720p、1080p。
	boolean	否	是否添加背景音乐。:系统将从预设 BGM 库中自动挑选合适的音乐并添加;:不添加 BGM。注:BGM 参数在 q2 模型的 duration 为 9 或 10 秒时不生效;在 q3 模型中不生效。
	boolean	否	音视频直出(仅 q3 模型支持)。:需要音视频直出,输出带台词以及背景音的视频;:不需要音视频直出,输出静音视频。
	boolean	否	错峰模式。:错峰生成视频,积分更低;:即时生成视频。
	boolean	否	是否添加水印。:添加水印;:不添加水印。注:水印内容固定为"内容由 AI 生成",默认不加。
	integer	否	水印位置。:左上角;:右上角;:右下角;:左下角。
	string	否	水印图片 URL。不传时使用默认水印。
	string	否	透传参数。不做任何处理,仅数据传输。
	string	否	元数据标识。JSON 格式字符串,透传字段。

请求示例

curl -X POST https://octopusx.ai/vidu/ent/v2/text2video \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '
{
  "model": "viduq3-pro",
  "style": "general",
  "prompt": "一只猫在草地上追逐蝴蝶",
  "duration": 5,
  "seed": 0,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "bgm": false,
  "audio": true,
  "off_peak": false,
  "watermark": false
}'

响应示例

{
  "task_id": "48038932-0ff5-4251-8b4b-7a76c09fd114",
  "status": "processing",
  "created_at": 1774494511
}

响应字段

名称	类型	说明
	string	任务 ID,用于查询任务状态。
	string	任务状态。可选值:(处理中)、(失败)、(已完成)。
	integer	创建时间戳(Unix 时间戳)。

相关接口

• Vidu 视频概览
• 视频系列概览
• 错误码查询