图生视频

文档版本：v1.0.0 | 最后更新：2026-06-11
本平台已完整适配 Vidu 系列官方视频生成接口，请求与响应均为透传，参数语义与官方一致。

以首帧图片驱动生成视频。

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

请求参数

请求头

头部	必填	说明
`Content-Type`	是	`application/json`
`Authorization`	是	`Token {API_KEY}`

请求体

参数	类型	必填	默认值	说明
`model`	String	是		模型名称可选值：`viduq3-turbo`、`viduq3-pro`、`viduq3-pro-fast`、`viduq2-pro-fast`、`viduq2-pro`、`viduq2-turbo`、`viduq1`、`viduq1-classic`、`vidu2.0` - `viduq3-pro-fast`：高效生成优质音视频内容，生成速度更快，性价比高 - `viduq3-turbo`：对比 viduq3-pro，生成速度更快 - `viduq3-pro`：高效生成优质音视频内容，效果更好 - `viduq2-pro-fast`：价格触底、效果稳定，生成速度较 viduq2-turbo 提高 2–3 倍 - `viduq2-pro`：效果好，细节丰富 - `viduq2-turbo`：效果好，生成快 - `viduq1`：画面清晰，平滑转场，运镜稳定 - `viduq1-classic`：画面清晰，转场、运镜更丰富 - `vidu2.0`：生成速度快
`images`	Array[String]	是		首帧图像。模型以此图片为首帧画面生成视频。 - 支持图片 Base64 编码或图片 URL（确保可访问） - 仅支持 1 张图 - 支持 png、jpeg、jpg、webp 格式 - 图片比例需小于 1:4 或 4:1 - 图片大小不超过 50 MB - POST body 不超过 20MB，Base64 须包含内容类型前缀，如 `data:image/png;base64,{base64_encode}`
`prompt`	String	否		文本提示词。字符长度不超过 5000 个字符。注：若使用 `is_rec` 推荐提示词参数，模型将忽略此提示词
`audio`	Bool	否	false	是否使用音视频直出能力（q3-pro、q3-turbo、q3-pro-fast 默认为 `true`） - `true`：输出带台词及背景音的视频 - `false`：输出静音视频注 1：该参数为 `true` 时，`voice_id` 参数才生效注 2：该参数为 `true` 时，仅 q3 模型支持错峰
`audio_type`	String	否	all	音频类型，`audio` 为 `true` 时生效 - `all`：音效+人声 - `speech_only`：仅人声 - `sound_effect_only`：仅音效注：目前仅支持 q2、q1、2.0 系列模型的音频拆分
`voice_id`	String	否		音色 ID，q3 系列模型不生效。为空时系统自动推荐。
`is_rec`	Bool	否		是否使用推荐提示词 - `true`：系统自动推荐提示词并使用其生成视频 - `false`：根据输入的 prompt 生成视频注：启用后每个任务多消耗 10 积分
`bgm`	Bool	否	false	是否添加背景音乐注：q2 模型 duration 为 9s 或 10s 时不生效；q3 系列不生效
`duration`	Int	否		视频时长（秒）。默认值依模型而定： - `viduq3-pro`、`viduq3-turbo`、`viduq3-pro-fast`：默认 5，可选 1–16 - `viduq2-pro-fast`、`viduq2-pro`、`viduq2-turbo`：默认 5，可选 1–10 - `viduq1`、`viduq1-classic`：默认 5，可选 5 - `vidu2.0`：默认 4，可选 4、8
`seed`	Int	否		随机种子。不传或传 0 时使用随机数。
`resolution`	String	否		分辨率。默认值依模型和时长而定： - `viduq3-pro-fast`（1–16s）：默认 720p，可选 720p、1080p - `viduq3-pro`、`viduq3-turbo`（1–16s）：默认 720p，可选 540p、720p、1080p - `viduq2-pro-fast`（1–10s）：默认 720p，可选 720p、1080p - `viduq2-pro`、`viduq2-turbo`（1–10s）：默认 720p，可选 540p、720p、1080p - `viduq1`、`viduq1-classic`（5s）：默认 1080p，可选 1080p - `vidu2.0`（4s）：默认 360p，可选 360p、720p、1080p - `vidu2.0`（8s）：默认 720p，可选 720p
`movement_amplitude`	String	否	auto	运动幅度。可选值：`auto`、`small`、`medium`、`large` 注：q2、q3 系列模型该参数不生效
`off_peak`	Bool	否	false	错峰模式注：除 q3 外的其他音视频直出功能不支持错峰模式
`watermark`	Bool	否	false	是否添加水印。默认不加。
`wm_position`	Int	否	3	水印位置 `1`：左上角，`2`：右上角，`3`：右下角，`4`：左下角
`wm_url`	String	否		自定义水印图片 URL。不传时使用默认水印。
`payload`	String	否		透传参数。最多 1048576 个字符。
`meta_data`	String	否		元数据标识，JSON 格式字符串，透传字段。
`callback_url`	String	否		回调地址。任务状态变化时以 POST 方式发送回调请求。

请求示例

响应参数

字段	类型	说明
`task_id`	String	任务 ID
`state`	String	处理状态：`created`、`queueing`、`processing`、`success`、`failed`
`model`	String	本次调用的模型名称
`prompt`	String	本次调用的提示词
`images`	Array[String]	本次调用的图像参数
`duration`	Int	视频时长
`audio`	Bool	是否使用音视频直出
`audio_type`	String	音频类型
`seed`	Int	随机种子
`resolution`	String	分辨率
`movement_amplitude`	String	运动幅度
`payload`	String	透传参数
`off_peak`	Bool	是否使用错峰模式
`credits`	Int	本次调用消耗的积分数
`watermark`	Bool	是否使用水印
`created_at`	String	任务创建时间

响应示例

{
  "task_id": "{task_id}",
  "state": "created",
  "model": "viduq3-pro",
  "images": ["https://example.com/image.png"],
  "prompt": "The astronaut waved and the camera moved up.",
  "duration": 5,
  "seed": 123456,
  "resolution": "1080p",
  "movement_amplitude": "auto",
  "payload": "",
  "off_peak": false,
  "credits": 8,
  "created_at": "2025-01-01T15:41:31.968916Z"
}

02-图生视频

图生视频#

请求参数#

请求头#

请求体#

请求示例#

响应参数#

响应示例#

图生视频

请求参数

请求头

请求体

请求示例

响应参数

响应示例