该接口可以根据人物图片生成数字人视频。

请求信息

请求 URL

POST /hub/vidu/v2/digital-human

请求头

Header	必填	示例值
Authorization	是	Bearer sk-xxxxx
Content-Type	是	application/json; charset=utf-8

请求体

字段	类型	必填	说明
model	string	是	模型名称。常见可选值：viduq2-turbo、viduq2-pro，默认通常使用 turbo
image	string	是	人物图片，支持 URL 或 Base64。通常仅支持 1 张；图片比例建议在 1:4 到 4:1 之间，文件不超过 50MB
prompt	string	否	视频提示词，最长 2000 字符，用来控制数字人的画面内容
audio_url	string	否	驱动音频，与 text 二选一；若同时传入，通常优先使用 audio_url
text	string	否	驱动文本，与 audio_url 二选一
voice_id	string	否	音色 ID，仅文本模式生效
resolution	string	否	输出分辨率，默认通常为 720p。常见可选值：540p、720p、1080p
payload	string	否	透传字段，最长 1048576 字符
callback_url	string	否	任务状态回调地址，具体规范请参考 。

请求示例

httpPOST /hub/vidu/v2/digital-human
Authorization: Bearer sk-xxxxx
Content-Type: application/json; charset=utf-8

json{
  "model": "viduq2-turbo",
  "image": "https://example.com/human.png",
  "prompt": "人物坐在桌前面向镜头轻微点头。",
  "audio_url": "https://example.com/voice.mp3",
  "resolution": "1080p",
  "payload": ""
}

响应信息

响应体

字段	类型	说明
task_id	string	任务 ID
state	string	任务状态。常见值：created、queueing、processing、success、failed
image	string	输入图片
prompt	string	提示词
audio_url	string	输入音频
text	string	输入文本
voice_id	string	音色 ID
resolution	string	分辨率
payload	string	透传字段
credits	string	消耗量
created_at	string	创建时间

响应示例

json{
  "task_id": "tsk_1234567896",
  "state": "created",
  "image": "https://example.com/human.png",
  "prompt": "人物坐在桌前面向镜头轻微点头。",
  "audio_url": "https://example.com/voice.mp3",
  "text": "",
  "voice_id": "",
  "resolution": "1080p",
  "payload": "",
  "credits": "8.000000",
  "created_at": "2026-04-16T09:36:00Z"
}

错误码

完整列表请参考客户端 API 错误码。