Skip to main content
POST
/
kling
/
v1
/
videos
/
advanced-lip-sync
cURL
curl --request POST \
+  --url https://api.deerapi.com/kling/v1/videos/advanced-lip-sync \
+  --header 'Authorization: Bearer <DEERAPI_KEY>' \
+  --header 'Content-Type: application/json' \
+  --data '{
    "session_id": "session_xxx",
    "face_choose": [
      {
        "face_id": "0",
        "sound_file": "https://example.com/lipsync-audio.mp3",
        "sound_start_time": "1200",
        "sound_end_time": "5000",
        "sound_insert_time": "0",
        "sound_volume": "1.0",
        "original_audio_volume": "0.5"
      }
    ],
    "callback_url": "https://example.com/kling/callback"
  }'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "task_info": {
      "external_task_id": "<string>"
    },
    "created_at": 123,
    "updated_at": 123
  }
}
/kling/v1/videos/advanced-lip-sync 负责把已识别的人脸和一段音频对齐。它依赖上一步的人脸识别结果,因此更像对口型 workflow 的第二步,而不是独立入口。

推荐流程

1

先拿到 session_id 和 face_id

这两个值来自 【对口型】人脸识别。没有上游识别结果,就不要直接调用创建任务接口。
2

第一次只做单人脸、单音频片段

首轮只放一个 face_choose 项,先用最简单的音频片段验证嘴型是否能稳定对齐。
3

把时间线关系写清楚

face_choose 里不只是人脸 ID,还包括音频片段的起止时间、插入时间和音量配置。先保证映射关系正确,再追求更复杂的剪辑效果。
4

决定结果回收方式

创建成功后保存 task_id,然后用 查询任务 轮询,或者直接配置 Callback 协议
face_choose 不是简单的人脸列表,而是“人脸 + 音频片段 + 插入时间”的映射。第一次接入先做单人脸、单音频片段,排错成本最低。

常见误解

  • 想用这页从照片直接生成说话视频;那是 Kling 数字人创建任务 的场景。
  • 上游还没拿到 session_id,就直接拼一个请求体调用创建任务。
  • 一开始就尝试多张人脸、多个片段和复杂音量混音。

相关页面

【对口型】人脸识别

对口型流程第一步,先拿到 session_id 和可选人脸信息。

语音合成

没有可用音频时,可以先把文本转成 TTS 音频。

查询任务

对口型任务提交后,按通用视频任务方式查询。

Callback 协议

适合把对口型结果直接回推到你的服务端。

Authorizations

Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Body

application/json

当前页面不使用 model_name;关键在于 session_id、face_id 和音频片段的时间范围是否匹配。

session_id
string
required

基于 identify-face 返回的会话 ID。

face_choose
object[]
required

指定要执行对口型的人脸与音频片段配置,当前建议先从单人脸开始。

callback_url
string

任务结果回调通知地址。

external_task_id
string

自定义任务 ID,用于业务侧映射和后续排查。

Response

200 - application/json

任务已受理,返回 task_id。后续请通过查询接口或 callback 获取最终对口型视频。

code
integer
required

返回码。

message
string
required

错误信息或成功说明。

request_id
string
required

请求唯一标识。

data
object
required