文生视频

根据文本提示词生成视频。

POST https://platform.shuyanai.com/vidu/ent/v2/text2video

请求参数

请求头

头部	必填	说明
`Content-Type`	是	`application/json`
`Authorization`	是	`Bearer sk-xxx`

请求体

参数	类型	必填	说明
`model`	String	是	模型名称。可选值：`viduq3-turbo`、`viduq3-pro`、`viduq2`、`viduq1`。 - `viduq3-turbo`：对比 viduq3-pro，生成速度更快 - `viduq3-pro`：生成音视频内容，效果更好 - `viduq2`：动态效果好，细节丰富 - `viduq1`：画面清晰，平滑转场，运镜稳定当前在售型号以模型广场为准
`prompt`	String	是	文本提示词，不超过 5000 个字符
`style`	String	否	风格。默认 `general`，可选值：`general`（通用风格，可通过提示词控制）、`anime`（动漫风格）。注：q2、q3 系列模型该参数不生效
`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	否	分辨率，默认值依模型而定： - `viduq3-pro`、`viduq3-turbo`（1–16 秒）：默认 720p，可选 540p、720p、1080p - `viduq2`（1–10 秒）：默认 720p，可选 540p、720p、1080p - `viduq1`（5 秒）：默认 1080p，可选 1080p
`movement_amplitude`	String	否	运动幅度。默认 `auto`，可选值：`auto`、`small`、`medium`、`large`。注：q2、q3 系列模型该参数不生效
`audio`	Bool	否	是否使用音视频直出：`true` 输出带台词和音效的视频，`false` 输出静音视频。注：仅 q3 系列模型支持，默认 `true`
`bgm`	Bool	否	是否添加背景音乐，默认 `false`。传 `true` 时从预设 BGM 库自动挑选。注：q2 模型 duration 为 9 秒或 10 秒时不生效；q3 系列模型不生效
`off_peak`	Bool	否	错峰模式，默认 `false`。`true`：错峰生成，任务在 48 小时内完成；`false`：即时生成
`watermark`	Bool	否	是否添加水印，默认不加
`wm_position`	Int	否	水印位置：`1` 左上角，`2` 右上角，`3` 右下角（默认），`4` 左下角
`wm_url`	String	否	自定义水印图片 URL，不传时使用默认水印
`payload`	String	否	透传参数，不做处理，最多 1048576 个字符
`meta_data`	String	否	元数据标识，JSON 格式字符串，透传字段
`callback_url`	String	否	回调地址。任务状态变化时以 POST 方式发送回调，失败最多重试 3 次

请求示例

响应参数

字段	类型	说明
`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	分辨率
`bgm`	Bool	是否添加背景音乐
`movement_amplitude`	String	运动幅度
`payload`	String	透传参数
`off_peak`	Bool	是否使用错峰模式
`credits`	Int	本次调用消耗的 Vidu 积分数
`watermark`	Bool	是否使用水印
`created_at`	String	任务创建时间

响应示例

{
  "task_id": "{task_id}",
  "state": "created",
  "model": "viduq3-pro",
  "style": "general",
  "prompt": "超写实时尚摄影风格，一名身穿宇航服的宇航员在雾中行走",
  "duration": 5,
  "seed": 123456,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "movement_amplitude": "auto",
  "payload": "",
  "off_peak": false,
  "credits": 8,
  "created_at": "2025-01-01T15:41:31.968916Z"
}

缺少必填参数时返回 400，例如未传 prompt：

{
  "code": "fail_to_fetch_task",
  "message": "{\"code\":400, \"reason\":\"FieldLacking\", \"message\":\"prompt is required\", \"metadata\":{\"fields\":\"prompt\", \"trace_id\":\"xxx\"}}",
  "data": null
}

任务创建后，使用查询任务接口获取生成结果。

01-文生视频

文生视频#

请求参数#

请求头#

请求体#

请求示例#

响应参数#

响应示例#

文生视频

请求参数

请求头

请求体

请求示例

响应参数

响应示例