POST
https://zx1.deepwl.net
/
vidu
/
ent
/
v2
/
reference2video
Vidu 参考生视频
curl --request POST \
  --url https://zx1.deepwl.net/vidu/ent/v2/reference2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "subjects": [
    {}
  ],
  "subjects[].id": "<string>",
  "subjects[].images": [
    {}
  ],
  "subjects[].voice_id": "<string>",
  "prompt": "<string>",
  "audio": true,
  "voice_id": "<string>",
  "is_rec": true,
  "bgm": true,
  "duration": 123,
  "seed": 123,
  "resolution": "<string>",
  "off_peak": true,
  "watermark": true,
  "wm_position": 123,
  "wm_url": "<string>",
  "payload": "<string>",
  "meta_data": "<string>"
}
'
{
  "task_id": "48038932-0ff5-4251-8b4b-7a76c09fd114",
  "status": "processing",
  "created_at": 1774494511
}

​
Vidu 参考生视频

Vidu 官方格式参考生视频接口,以 application/json 提交。
  • 路由入口是 POST /vidu/ent/v2/reference2video。
  • 当前使用 application/json 提交。
  • 支持主体参考生成视频(多主体)。
  • 提交成功后返回任务 task_id 与 status,后续用 查询任务 轮询结果。

​
支持模型

  • viduq3-pro: 高效生成优质音视频内容,让视频内容更生动、更形象、更立体
  • viduq2-pro / viduq2-turbo: 新模型,效果好,细节丰富
  • viduq2-pro-fast: 价格触底,生成速度快
  • viduq1 / viduq1-classic: 画面清晰,运镜稳定
  • vidu2.0: 生成速度快

​
方法与路径

POST /vidu/ent/v2/reference2video

​
请求示例

curl -X POST https://zx1.deepwl.net/vidu/ent/v2/reference2video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -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"
  }'

​
响应示例

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

​
认证

Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
必填
模型名称。支持 viduq3-pro、viduq2-pro、viduq2-turbo、viduq2-pro-fast、viduq1、viduq1-classic、vidu2.0。
​
subjects
array
必填
主体数组。支持多个主体,每个主体包含 id(主体 ID)、images(该主体对应的图片 URL,每个主体最多支持 3 张图片)、voice_id(音色 ID,可选)。
​
subjects[].id
string
必填
主体 ID。后续生成时可以通过 @主体 ID 的方式使用。
​
subjects[].images
array
必填
主体图片。注 1:支持图片 Base64 编码或图片 URL。注 2:图片格式:png、jpeg、jpg、webp。注 3:图片像素不能小于 128*128,且比例需要小于 1:4 或 4:1,且大小不超过 50M。注 4:HTTP 请求的 POST body 不超过 20MB,且编码必须包含内容类型字符串,例如:data:image/png;base64,{base64_encode}。
​
subjects[].voice_id
string
音色 ID。用来决定视频中的声音音色,为空时系统会自动推荐。可选枚举值参考:新音色列表,或使用声音复刻 API 来复刻任意音色,voice_id 可以互通。
​
prompt
string
文本提示词。生成视频的文本描述,可以通过 @主体 ID 引用主体。若使用 is_rec 推荐提示词参数,模型将不考虑此参数所输入的提示词。
​
audio
boolean
音视频直出。true:输出带台词以及背景音的视频;false:输出静音视频。
​
voice_id
string
音色 ID(全局)。用来决定视频中的声音音色,为空时系统会自动推荐。注:q3 模型不生效。
​
is_rec
boolean
是否使用推荐提示词。true:系统自动推荐提示词;false:根据输入的 prompt 生成视频。
​
bgm
boolean
背景音乐。true:系统将从预设 BGM 库中自动挑选合适的音乐并添加;false:不添加 BGM。
​
duration
integer
视频时长(秒)。viduq2 系列:默认 5 秒,可选 1-10 秒。
​
seed
integer
随机种子。不传或传 0 时使用随机数,手动设置则使用指定种子。
​
resolution
string
分辨率。默认值依据模型和视频时长而定。viduq2(1-10 秒):默认 720p,可选 540p、720p、1080p。
​
off_peak
boolean
错峰模式。true:错峰生成视频;false:即时生成视频。
​
watermark
boolean
是否添加水印。true:添加水印;false:不添加水印。
​
wm_position
integer
水印位置。1:左上角;2:右上角;3:右下角;4:左下角。
​
wm_url
string
水印图片 URL。不传时使用默认水印:“内容由 AI 生成”。
​
payload
string
透传参数。不做任何处理,仅数据传输。
​
meta_data
string
元数据标识。JSON 格式字符串,透传字段。

​
Response

​
task_id
string
任务 ID,用于查询任务状态。
​
status
string
任务状态。可选值:processing(处理中)、failed(失败)、completed(已完成)。
​
created_at
integer
创建时间戳(Unix 时间戳)。

​
相关接口