任务：视频配音-对口型

POST

/kling/v1/videos/lip-sync

查看示例：（示例有效期30天-如无法查看说明已过期）

查看原视频

查看配音后视频

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json

input

object

必需

video_id

string

视频ID（注意：不是任务ID）

必需

通过可灵AI生成的视频的ID

用于指定视频、判断视频是否可用于对口型服务
与input·video_url参数二选一填写，不能同时为空，也不能同时有值
仅支持使用30天内生成的5秒视频和10秒视频，超过10秒的视频不支持对口型

如果原视频是10秒，则扣费x2倍

video_url

string

视频链接

必需

所上传视频的获取链接

用于指定视频，并判断视频是否可用于对口型服务
与input·video_id参数二选一填写，不能同时为空，也不能同时有值
视频文件支持.mp4/.mov，文件大小不超过100MB，视频时长不超过10s且不短于2s，仅支持720p和1080p、长宽的边长均位于720px~1920px之间，上述校验不通过会返回错误码等信息
系统会校验视频内容，如有问题会返回错误码等信息

mode

enum<string>

视频模式

必需

○ text2video：文本生成视频模式，此模式时input·text、input·voice_id、input·voice_language参数为必填；音频生成视频模式相关参数无效
○ audio2video：音频生成视频模式，此模式时input·audio_type参数为必填，文本生成视频模式相关参数无效

枚举值:

text2videoaudio2video

示例值:

text2video

text

string

口型文字

可选

● input·mode参数值为text2video时，当前参数必填
● 文本内容最大长度120，内容过长会返回错误码等信息
● 系统会校验文本内容，如有问题会返回错误码等信息

voice_id

string

音色ID

可选

● input·mode参数值为text2video时，当前参数必填
● 系统提供多种音色可供选择，具体音色效果、音色ID、音色语种对应关系点此查看；音色试听不支持自定义文案
● 音色试听文件命名规范：音色名称#音色ID#音色语种

voice_language

enum<string>

音色语种

可选

● input·mode参数值为text2video时，当前参数必填
● 音色语种与音色ID对应，详见上文

枚举值:

zhen

默认值:

示例值:

voice_speed

number

语速

可选

● 有效范围：0.8~2.0，精确至小数点后1位，超出部分将自动四舍五入
● input·mode参数值为text2video时，当前参数必填

>= 0.8< 2

默认值:

audio_type

string

音频文件类型

可选

● 枚举值：file，url
● file：上传文件模式，此时input·audio_file参数必填
● url：提供下载链接模式，此时input·audio_url参数必填
● input·mode参数值为audio2video时，当前参数必填

audio_file

string

音频文件路径

可选

● input·audio_type参数值为file时，当前参数必填
● 音频文件支持.mp3/.wav/.m4a/.acc，文件大小不超过5MB，Base64编码，格式不匹配或文件过大会返回错误码等信息
● 系统会校验音频内容，如有问题会返回错误码等信息

audio_url

string

音频文件地址

可选

● input·audio_type参数值为url时，当前参数必填
● 音频文件支持.mp3/.wav/.m4a/.acc，文件大小不超过5MB，格式不匹配或文件过大会返回错误码等信息
● 系统会校验音频内容，如有问题会返回错误码等信息

callback_url

string

通知地址

可选

本次任务结果回调通知地址，详见 CallBack协议

示例

{
  "input": {
    "video_id": "c01bbafe-712e-4a00-8265-fe7b4e9b17bf",
    "mode": "text2video",
    "text": "天空一声巨响，老娘闪亮登场",
    "voice_id": "chat1_female_new-3",
    "voice_language":"zh"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.gpt.ge/kling/v1/videos/lip-sync' \
--header 'Content-Type: application/json' \
--data-raw '{
  "input": {
    "video_id": "c01bbafe-712e-4a00-8265-fe7b4e9b17bf",
    "mode": "text2video",
    "text": "天空一声巨响，老娘闪亮登场",
    "voice_id": "chat1_female_new-3",
    "voice_language":"zh"
  }
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object

必需

task_id

string

必需

action

string

必需

status

string

必需

fail_reason

string

必需

submit_time

integer

必需

start_time

integer

必需

finish_time

integer

必需

progress

string

必需

data

object

必需

created_at

integer

必需

updated_at

integer

必需

task_result

object

必需

task_status

string

必需

task_status_msg

string

必需

request_id

string

必需

示例

{
    "code": 0,
    "message": "SUCCEED",
    "request_id": "ClpejWduJGYAAAAAAUvWMw",
    "data": {
        "task_id": "ClpejWduJGYAAAAAAUvWMw",
        "task_status": "submitted",
        "created_at": 1736058335197,
        "updated_at": 1736058335197
    }
}

修改于 2025-06-04 03:56:10

任务：视频延长

任务：视频特效-单图