Documentation

对口型

Last updated: Nov 4, 2026

POST
/v3/aigc/pv/video/lip_sync/generate

为视频生成对口型。音频来源三选一:audio_url,或 lip_sync_tts_speaker_id + lip_sync_tts_content,或 audio_file。视频来源二选一:source_video_url 或 video_media_id。

返回 任务 ID,可通过 任务详情接口查询状态。

说明

lip_sync_tts_speaker_id 取值

ID音色ID音色
Auto随机18豫语汉子
14呆萌王小拍19宝岛囡囡
6李解20陕西掌柜
13钱多多21港风阿sir
2詹有鱼22ads_promale
4外国阿利23ads_youngmale
12李杰克24ads_gracefemale
11老森25ads_jiangchuan_male
10姜姜好26ads_panpan_female
16屯里大嗓28ads_zhouyun_female

使用 TE 北京地域 API Key 鉴权。模型能力、调用约定见 PixVerse 接口概览。

Authorization

BearerAuth
headerAuthorizationBearer <token>

TE 北京地域 API Key,填写后自动添加 Bearer 前缀。

Request Body

application/json
  1. body
audio_url?string

音频 URL

lip_sync_tts_speaker_id?string

预设音色 ID,见下表

lip_sync_tts_content?string

TTS 文本

audio_file?string

Base64 音频,不带前缀

source_video_url?string

视频 URL

video_media_id?string

视频媒资 ID,mda- 开头

Response Body

成功;具体状态及结果见响应字段。

application/json
  1. response
taskId?string

任务 ID

requestId?string

请求 ID,用于排查

code?string

错误码,异常时返回

message?string

错误信息,异常时返回

Example Request
curl -X POST 'https://vod.bj.baidubce.com/v3/aigc/pv/video/lip_sync/generate' \  -H 'Content-Type: application/json' \  -d '{  "audio_url": "https://example.com/audio.mp3",  "source_video_url": "https://example.com/video.mp4"}'
Example Response200
{  "taskId": "tsk-xxxxxxxxxxxxxxxx",  "requestId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}