POST/kling/v1/videos/advanced-lip-sync

对口型

API Key application/json

Request

请求

/kling/v1/videos/advanced-lip-sync

Body

必填

Bodyobject

session_idstring必填

会话ID，会基于对口型人脸识别接口生成

face_choosearray<object>必填

指定人脸对口型;包括人脸ID、口型参考等内容等;暂时仅支持指定单人对口型

元素object

face_idstring必填

人脸ID由人脸识别接口返回

audio_idstring

通过试听接口生成的音频的ID仅支持使用30天内生成的、时长不短于2秒且不超过60秒的音频/audio_id、sound_file参数二选一，不能同时为空，也不能同时有值

sound_filestring

音频文件支持传入音频Base64编码或图音频URL（确保可访问）音频文件支持.mp3/.wav/.m4a，文件大小不超过5MB，格式不匹配或文件过大会返回错误码等信息仅支持使用时长不短于2秒且不长于60秒的音频 audio_id、sound_file参数二选一，不能同时为空，也不能同时有值系统会校验音频内容，如有问题会返回错误码等信息

sound_start_timeinteger必填

音频裁剪起点时间;以原始音频开始时间为准，开始时间为0分0秒，单位ms;起点之前的音频会被裁剪，裁剪后音频不得短于2秒

sound_end_timeinteger必填

音频裁剪终点时间终点时间不得晚于原始音频总时长

sound_insert_timeinteger必填

裁剪后音频插入时间插入音频的时间范围与该人脸可对口型时间区间至少重合2秒时长插入音频的开始时间不得早于视频开始时间，插入音频的结束时间不得晚于视频结束时间

sound_volumeinteger必填

音频音量大小；值越大，音量越大取值范围：[0, 2]

original_audio_volumeinteger必填

原始视频音量大小；值越大，音量越大取值范围：[0, 2];原视频无声时，当前参数无效果

external_task_idstring

callback_urlstring

路径、查询与 Header 参数

参数	位置	类型	必填	说明	示例
`Content-Type`	Header	string	否	-	application/json
`Authorization`	Header	string	是	必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。	Bearer YOUR_API_KEY

请求示例application/json

curl -X POST https://top.qingyuntop.ai/kling/v1/videos/advanced-lip-sync \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "session_id": "825465778199224380",
  "face_choose": [
    {
      "face_id": "-1",
      "audio_id": "825451760499568680",
      "sound_file": "",
      "sound_start_time": 0,
      "sound_end_time": 5000,
      "sound_insert_time": 1000,
      "sound_volume": 1,
      "original_audio_volume": 1
    }
  ],
  "external_task_id": "",
  "callback_url": ""
}'

Response

返回响应 `200`

HTTP 响应

响应 200object

对口型

请求

Body

路径、查询与 Header 参数

返回响应 200

返回响应 `200`