lip-sync - API reference

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Authorization

string

optional

Default:

Body Params application/json

input

object

required

video_id

string

required

通过可灵AI生成的视频的ID。仅支持使用30天内生成的5秒视频和10秒视频，超过10秒的视频不支持对口型

mode

enum<string>

required

生成视频的模式

Allowed values:

text2videoaudio2video

text

string

optional

生成对口型视频的文本内容

<= 120 characters

voice_id

string

optional

音色ID

https://docs.qingque.cn/s/home/eZQDvafJ4vXQkP8T9ZPvmye8S?identityId=2Cn18n4EIHT

voice_language

enum<string>

optional

音色语种，与音色ID对应

Allowed values:

zhen

Default:

zh

voice_speed

number

optional

语速

>= 0.8<= 2

Default:

1

audio_type

enum<string>

optional

音频文件传输方式

Allowed values:

fileurl

audio_file

string

optional

音频文件本地路径（Base64编码），支持.mp3/.wav/.m4a/.acc，文件大小不超过5MB

audio_url

string <uri>

optional

音频文件下载url，支持.mp3/.wav/.m4a/.acc，文件大小不超过5MB

task_id

string

任务id

required

callback_url

string <uri>

optional

任务结果回调通知地址

Example

{
  "input": {
    "task_id": "ClpejWduJGYAAAAAAN9B-w",
    "video_id": "de1b86d9-8e40-4f1c-a6a5-6459f8eb42f2",
    "mode": "text2video",
    "text": "今天天气很好",
    "voice_id": "girlfriend_1_speech02",
    "voice_language": "zh"
  }
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request POST '/kling/v1/videos/lip-sync' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "input":{
        "task_id":"ClpejWduJGYAAAAAAN9B-w",
        "video_id":"de1b86d9-8e40-4f1c-a6a5-6459f8eb42f2",
        "mode":"text2video",
        "text":"今天天气很好",
        "voice_id":"girlfriend_1_speech02",
        "voice_language":"zh"
    }
}'

Responses

🟠404记录不存在

application/json

Body

error

object

required

message

string

required

type

string

required

code

string

required

Example

{
  "error": {
    "message": "string",
    "type": "string",
    "code": "string"
  }
}