该接口可以为视频人物生成匹配口型。

请求信息

请求 URL

POST /hub/vidu/v2/lip-sync

请求头

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

请求体

字段	类型	必填	说明
video_url	string	是	原视频地址。支持 mp4、mov、avi；时长通常要求 1-600 秒，建议 10-120 秒；文件通常要求不超过 5GB，编码建议 H.264
audio_url	string	否	音频地址，与 text 二选一；若同时传入，通常优先生效。支持 wav、mp3、wma、m4a、aac、ogg
text	string	否	文本内容，与 audio_url 二选一。常见限制为 4-2000 字符，支持使用换行和 <#x#> 控制停顿
speed	float	否	语速，仅文本模式生效。常见范围：0.5-2，默认 1.0
voice_id	string	否	音色 ID，仅文本模式生效
ref_photo_url	string	否	多脸场景下的人脸参考图，用于指定目标人物
volume	int	否	音量，仅文本模式生效。常见范围：0-10，默认 0
callback_url	string	否	任务状态回调地址，具体规范请参考 。

请求示例

• 音频驱动：

  json{
  "video_url": "https://example.com/source.mp4",
  "audio_url": "https://example.com/speech.mp3"
  }
  

• 文本驱动：

  json{
  "video_url": "https://example.com/source.mp4",
  "text": "你好，欢迎使用 AIHub 开放平台。",
  "voice_id": "voice_cn_female",
  "speed": 1.0,
  "volume": 0
  }
  

响应信息

响应体

字段	类型	说明
task_id	string	任务 ID
state	string	任务状态。常见值：created、queueing、processing、success、failed
payload	string	透传字段
created_at	string	创建时间

响应示例

json{
  "task_id": "tsk_1234567897",
  "state": "created",
  "payload": "",
  "created_at": "2026-04-16T09:37:00Z"
}

错误码

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