Vidu 图生视频
提交首帧图生成视频任务。
http
POST /vidu/ent/v2/img2video当前可用模型
| 模型 | 说明 |
|---|---|
| Q3 旗舰，支持音视频直出 | |
| Q2 Pro | |
| Q2 加速版 | |
| Q2 Pro 快速版 | |
| 画面清晰，运镜稳定 | |
| Q1 经典版 | |
| 2.0 版本 |
请求头
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 是 | 请求身份认证。使用 Bearer Token，示例值：。 | |
| string | 是 | 请求内容类型，必须设置为 。 |
请求体
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 是 | 模型名称，可选值见上方「当前可用模型」。 | |
| array | 是 | 首帧图像。只支持输入 1 张图,支持图片 Base64 编码或图片 URL。图片格式:png、jpeg、jpg、webp。图片比例需要小于 1:4 或 4:1,图片大小不超过 50 MB。 | |
| string | 否 | 文本提示词。生成视频的文本描述。若使用 推荐提示词参数,模型将不考虑此参数所输入的提示词。 | |
| boolean | 否 | 音视频直出。:输出带台词以及背景音的视频;:输出静音视频。 | |
| string | 否 | 音色 ID。用来决定视频中的声音音色,为空时系统会自动推荐。注:q3 模型不生效。 | |
| boolean | 否 | 是否使用推荐提示词。:系统自动推荐提示词(推荐提示词数量=1);:根据输入的 prompt 生成视频。 | |
| boolean | 否 | 背景音乐。:系统将从预设 BGM 库中自动挑选合适的音乐并添加;:不添加 BGM。 | |
| integer | 否 | 视频时长(秒)。 系列:默认 5 秒,可选 1-10 秒。 | |
| integer | 否 | 随机种子。不传或传 0 时使用随机数,手动设置则使用指定种子。 | |
| string | 否 | 分辨率。默认值依据模型和视频时长而定。(1-10 秒):默认 720p,可选 540p、720p、1080p。 | |
| boolean | 否 | 错峰模式。:错峰生成视频;:即时生成视频。 | |
| boolean | 否 | 是否添加水印。:添加水印;:不添加水印。 | |
| integer | 否 | 水印位置。:左上角;:右上角;:右下角;:左下角。 | |
| string | 否 | 水印图片 URL。不传时使用默认水印:"内容由 AI 生成"。 | |
| string | 否 | 透传参数。不做任何处理,仅数据传输。 | |
| string | 否 | 元数据标识。JSON 格式字符串,透传字段。 |
请求示例
bash
curl -X POST https://octopusx.ai/vidu/ent/v2/img2video \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '
{
"model": "viduq3-pro",
"images": ["https://example.com/first-frame.png"],
"prompt": "让人物向前走并微笑",
"audio": true,
"is_rec": false,
"bgm": false,
"duration": 5,
"seed": 0,
"resolution": "720p",
"off_peak": false,
"watermark": false
}'响应示例
json
{
"task_id": "48038932-0ff5-4251-8b4b-7a76c09fd114",
"status": "processing",
"created_at": 1774494511
}响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
| string | 任务 ID,用于查询任务状态。 | |
| string | 任务状态。可选值:(处理中)、(失败)、(已完成)。 | |
| integer | 创建时间戳(Unix 时间戳)。 |