创建对口型任务

POST

/v1/videos/lip-sync

最后修改时间：2026-11-05 07:26:37

对视频中的人物进行口型同步。视频输入可使用 Kling 生成的视频 ID 或可访问的视频 URL，video_id 与 video_url 二选一，不能同时为空或同时提供。
mode=text2video 时使用文本和音色生成语音；mode=audio2video 时使用音频文件驱动口型。

请求参数

Header 参数

Body 参数application/json必填

示例

textToSpeechaudioFile

{
    "input": {
        "video_id": "827964097668337738",
        "mode": "text2video",
        "text": "今天天气很好",
        "voice_id": "girlfriend_1_speech02",
        "voice_language": "zh"
    },
    "callback_url": "https://example.com/callback",
    "external_task_id": "lipsync_001"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

textToSpeechaudioFile

curl --location '/v1/videos/lip-sync' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "input": {
        "video_id": "827964097668337738",
        "mode": "text2video",
        "text": "今天天气很好",
        "voice_id": "girlfriend_1_speech02",
        "voice_language": "zh"
    },
    "callback_url": "https://example.com/callback",
    "external_task_id": "lipsync_001"
}'

返回响应

🟢200

application/json

任务提交成功

Bodyapplication/json

示例

{
    "code": 0,
    "message": "string",
    "request_id": "string",
    "data": {
        "task_id": "string",
        "task_status": "submitted",
        "task_info": {
            "external_task_id": "string"
        },
        "created_at": 0,
        "updated_at": 0
    }
}

🟠400

🟠401

修改于 2026-11-05 07:26:37

动作控制

Blend提交参数