输入关键词搜索

对口型

更新时间: 2026/08/27 10:13:38

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

请求信息

请求 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 错误码。

此文档是否对你有帮助?
有帮助
去反馈
  • 请求信息
  • 请求 URL
  • 请求头
  • 请求体
  • 请求示例
  • 响应信息
  • 响应体
  • 响应示例
  • 错误码