Vidu 参考生视频
提交主体参考生成视频任务。
http
POST /vidu/ent/v2/reference2video当前可用模型
| 模型 | 说明 |
|---|---|
| Q3 旗舰，支持音视频直出 | |
| Q2 Pro | |
| Q2 加速版 | |
| Q2 Pro 快速版 | |
| 画面清晰，运镜稳定 | |
| Q1 经典版 | |
| 2.0 版本 |
请求头
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 是 | 请求身份认证。使用 Bearer Token，示例值：。 | |
| string | 是 | 请求内容类型，必须设置为 。 |
请求体
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 是 | 模型名称，可选值见上方「当前可用模型」。 | |
| array | 是 | 主体数组。支持多个主体,每个主体包含 (主体 ID)、(该主体对应的图片 URL,每个主体最多支持 3 张图片)、(音色 ID,可选)。其中 为主体 ID，后续生成时可以通过 的方式使用。 | |
| array | 是 | 主体图片。注 1:支持图片 Base64 编码或图片 URL。注 2:图片格式:png、jpeg、jpg、webp。注 3:图片像素不能小于 128*128,且比例需要小于 1:4 或 4:1,且大小不超过 50M。注 4:HTTP 请求的 POST body 不超过 20MB,且编码必须包含内容类型字符串,例如:。 | |
| string | 否 | 音色 ID。用来决定视频中的声音音色,为空时系统会自动推荐。可选枚举值参考:新音色列表,或使用声音复刻 API 来复刻任意音色,voice_id 可以互通。 | |
| string | 否 | 文本提示词。生成视频的文本描述,可以通过 引用主体。若使用 推荐提示词参数,模型将不考虑此参数所输入的提示词。 | |
| boolean | 否 | 音视频直出。:输出带台词以及背景音的视频;:输出静音视频。 | |
| string | 否 | 音色 ID(全局)。用来决定视频中的声音音色,为空时系统会自动推荐。注:q3 模型不生效。 | |
| boolean | 否 | 是否使用推荐提示词。:系统自动推荐提示词;:根据输入的 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/reference2video \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '
{
"model": "viduq3-pro",
"subjects": [
{
"id": "subject_1",
"images": ["https://example.com/subject.png"],
"voice_id": "voice_001"
}
],
"prompt": "让@subject_1 向前走并微笑",
"audio": true,
"is_rec": false,
"bgm": false,
"duration": 5,
"seed": 0,
"resolution": "720p"
}'响应示例
json
{
"task_id": "48038932-0ff5-4251-8b4b-7a76c09fd114",
"status": "processing",
"created_at": 1774494511
}响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
| string | 任务 ID,用于查询任务状态。 | |
| string | 任务状态。可选值:(处理中)、(失败)、(已完成)。 | |
| integer | 创建时间戳(Unix 时间戳)。 |