DeerAPI 对口型创建任务接入说明:聚焦 advanced-lip-sync 的两步流程、session_id 复用以及查询回调方式。
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 的第二步,而不是独立入口。
先拿到 session_id 和 face_id
决定结果回收方式
task_id,然后用 查询任务 轮询,或者直接配置 Callback 协议。face_choose 不是简单的人脸列表,而是“人脸 + 音频片段 + 插入时间”的映射。第一次接入先做单人脸、单音频片段,排错成本最低。session_id,就直接拼一个请求体调用创建任务。session_id 和可选人脸信息。Bearer token authentication. Use your DeerAPI key.
当前页面不使用 model_name;关键在于 session_id、face_id 和音频片段的时间范围是否匹配。
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
}
}