Kling
Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask
Kling 是功能最全面的视频生成模型之一,支持文生视频、首帧 / 首尾帧生视频,以及图片、视频的多模态参考生成。3.0-Omni / O1 支持多镜头(智能分镜)与视频编辑,并提供动作控制、口型同步、数字人、自定义音色等扩展能力,可同时生成音频。
基本信息
| 项目 | 值 |
|---|---|
| ModelName | Kling |
| ModelVersion | 4.0-Omni / 4.0 / 3.0-Omni / 3.0 / O1 / 2.6 / 2.5 / 2.1 / 2.0 / 1.6 |
| 是否支持护栏解除 | 支持 |
是 MPS AIGC 中功能最广的视频引擎。除 text-to-video、image-to-video(首/尾帧)、参考生成外,还通过 SceneType 和 AdditionalParameters 处理动作控制、口型同步、数字人、多镜头、自定义参考对象、自定义音色。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
ModelName | 必填 | String | 固定值 Kling |
ModelVersion | 选填 | String | 4.0-Omni / 4.0 / 3.0-Omni / 3.0 / O1 / 2.6 / 2.5 / 2.1 / 2.0 / 1.6 |
Prompt | 必填 | String | 生成 Prompt。文本输入模式下最多撰写 2000 个字符 |
NegativePrompt | 选填 | String | 结果中需排除的元素。仅在支持的模型上生效 |
EnhancePrompt | 选填 | Boolean | Prompt 自动校正。默认值 false |
ImageUrl | 选填 | String | 首帧图片 URL。必须可从外部访问且不超过 10MB |
LastImageUrl | 选填 | String | 尾帧图片 URL。需与 ImageUrl 一起使用 |
ImageInfos.N | 选填 | Array | 参考图片数组。如 Category / Url / ReferenceType 等 |
Duration | 选填 | Integer | 生成时长(秒)。仅生效各模型允许的值 |
ExtraParameters | 选填 | Object | Resolution / AspectRatio / EnableAudio |
AdditionalParameters | 选填 | String | 承载模型专属选项的 JSON 字符串。seed 的传递格式请参考 附加配置 |
SceneType | 选填 | String | motion_control(动作控制)、lip_sync(口型同步)、avatar_i2v(数字人)、multi_elements(多元素编辑) |
ExtraParameters.EnablelnputComplianceCheck | 选填 | Boolean | 显式传递 false 则解除输入审核。使用前请咨询商务负责人 |
ExtraParameters.EnableOutputComplianceCheck | 选填 | Boolean | 显式传递 false 则解除输出审核。使用前请咨询商务负责人 |
请求示例
text-to-video
文本生成需输入 Prompt,并通过 ExtraParameters 指定分辨率 / 宽高比 / 音频同步生成。
{
"ModelName": "Kling",
"ModelVersion": "3.0",
"Prompt": "a cat walking on the beach at sunset",
"Duration": 5,
"ExtraParameters": {
"Resolution": "1080P",
"AspectRatio": "16:9",
"EnableAudio": true
},
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"EnhancePrompt": false
}响应示例
{
"Response": {
"Status": "DONE",
"Message": "ok",
"Resolution": "1920x1080",
"VideoUrls": [
"https://aigc-output-video-<id>.cos.<region>.myqcloud.com/<file>.mp4?q-sign-algorithm=sha1&..."
],
"RequestId": "<request-id>"
}
}特殊配置
护栏解除
可分别配置输入和输出审核。
如需使用护栏解除参数,需先联系商务负责人确认使用权限。即使在支持的引擎上,也只有显式传递该参数时才会应用护栏解除。省略该参数则不会解除。
| 参数 | 解除值 | 适用对象 |
|---|---|---|
ExtraParameters.EnablelnputComplianceCheck | false | 解除输入审核 |
ExtraParameters.EnableOutputComplianceCheck | false | 解除输出审核 |
将以下配置合并到现有生成请求中。如需同时解除输入和输出审核,请一并传递这两个字段。
{
"ExtraParameters": {
"EnablelnputComplianceCheck": false,
"EnableOutputComplianceCheck": false
}
}各版本支持能力
| 版本 | 生成模式 | 最大参考图片 | 音频 | 时长 |
|---|---|---|---|---|
3.0-Omni | text / image / 参考生成 | 8 张 | 原声、配音、音效 | 3~15 秒 |
3.0 | text / image | 6 张 | 支持 | 3~15 秒 |
O1 | text / image / 参考生成 | 4 张 | 支持 | 3~10 秒 |
2.6 | text / image | 4 张 | 仅在参考生成 + pro 模式(1080P)下支持 | 5 秒,10 秒 |
2.1 / 2.0 / 1.6 | text,默认 image | — | 仅简单背景音 | 5 秒,10 秒 |
Kling 4.0(新版模型)
Kling 4.0 / 4.0-Omni 是最新一代版本,相比 3.0 系列把最大参考图提升到 10 张、单次生成时长拉长到 3~30 秒。调用方式与通用 Kling 一致,只需把 ModelVersion 换成 4.0 或 4.0-Omni,其余参数(Prompt / ImageUrl / ImageInfos.N / Duration / ExtraParameters 等)沿用本页上文的通用定义。
| 版本 | 生成模式 | 最大参考图 | 视频时长 |
|---|---|---|---|
4.0-Omni | 视频参考生视频 | 10 张 | 3~30 秒 |
4.0 | text / image(文生 / 图生视频) | 10 张 | 3~30 秒 |
4.0:面向文生视频与图生视频(首帧 / 首尾帧)的通用生成。4.0-Omni:面向视频参考生视频(以参考视频驱动生成),参考素材走ImageInfos.N/ 参考视频信息字段。
调用示例(text-to-video,4.0)
下方 JSON 中的
Prompt、Duration、分辨率、CosBucketName等均为示例 / 参考值,实际请以你的业务参数与真实数据为准。
{
"ModelName": "Kling",
"ModelVersion": "4.0",
"Prompt": "a cat walking on the beach at sunset",
"Duration": 10,
"ExtraParameters": {
"Resolution": "1080P",
"AspectRatio": "16:9"
},
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"EnhancePrompt": false
}调用示例(视频参考生视频,4.0-Omni)
参考视频 URL、
Duration等为示例 / 参考值,实际以真实素材与业务参数为准。
curl -X POST https://mps.tencentcloudapi.com \
-H "Content-Type: application/json" \
-H "X-TC-Action: CreateAigcVideoTask" \
-H "X-TC-Version: 2019-06-12" \
-H "X-TC-Region: ap-guangzhou" \
-H "Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<Date>/mps/tc3_request, SignedHeaders=content-type;host, Signature=<Signature>" \
-d '{
"ModelName": "Kling",
"ModelVersion": "4.0-Omni",
"Prompt": "recreate the scene following the reference video",
"ImageInfos": [
{ "Category": "Video", "Url": "https://<cdn>/reference.mp4" }
],
"Duration": 10,
"Operator": "admin"
}'image-to-video(首 / 尾帧)
通过 ImageUrl 指定首帧即为 image-to-video。若同时传入 LastImageUrl,则会衔接两个帧之间的画面。仅传入首帧时,输出宽高比沿用该图片的比例。尾帧在 2.0 / O1 / 3.0 / 3.0-Omni 中支持。
{
"ModelName": "Kling",
"ModelVersion": "3.0",
"Prompt": "smooth transition between two scenes",
"ImageUrl": "https://<cdn>/first.png",
"LastImageUrl": "https://<cdn>/last.png",
"Duration": 10,
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"EnhancePrompt": false
}参考生成(多图)
在 ImageInfos.N 中放入多张参考图片,并在 Prompt 中以 <<<image_1>>> / <<<image_2>>> 的形式指定每张图片。O1 和 3.0-Omni 最多支持 1~7 张,1.6 最多支持 1~4 张。
{
"ModelName": "Kling",
"ModelVersion": "3.0-Omni",
"Prompt": "<<<image_1>>> and <<<image_2>>> in the same scene",
"ImageInfos": [
{
"Category": "Image",
"Url": "https://<cdn>/ref1.png"
},
{
"Category": "Image",
"Url": "https://<cdn>/ref2.png"
}
],
"Duration": 10,
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"EnhancePrompt": false
}动作控制 (motion_control)
生成时让参考图片中的人物跟随指定的姿势与动作。指定 SceneType=motion_control,动作控制的详细选项以 AdditionalParameters 中的 JSON 字符串形式指定。支持 keep_original_sound / character_orientation 等。最新动作控制使用 ModelVersion=3.0,标准路径使用 2.6。
{
"ModelName": "Kling",
"ModelVersion": "3.0-Omni",
"SceneType": "motion_control",
"Prompt": "a person waves hand and turns around",
"ImageUrl": "https://<cdn>/first-frame.png",
"Duration": 5,
"ExtraParameters": {
"Resolution": "1080P",
"AspectRatio": "16:9"
},
"AdditionalParameters": "{\"keep_original_sound\":\"yes\"}",
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"EnhancePrompt": false
}口型同步 (lip_sync)
分两步进行。先通过人脸信息查询 API 获取 session_id 和 face_id,再将该值填入 AdditionalParameters 以创建生成任务。短且简单的视频使用同步 API DescribeAigcFaceInfo,长且复杂的视频使用异步 API DescribeAigcFaceInfoAsync。与版本无关,填入任意值均可生效。
curl -X POST https://mps.tencentcloudapi.com \
-H "X-TC-Action: DescribeAigcFaceInfo" \
-H "Content-Type: application/json" \
-H "X-TC-Version: 2019-06-12" \
-H "X-TC-Region: ap-guangzhou" \
-H "Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<Date>/mps/tc3_request, SignedHeaders=content-type;host, Signature=<Signature>" \
-d '{
"ImageUrl": "https://<cdn>/portrait.png",
"ModelName": "Kling",
"ModelVersion": "3.0"
}'curl -X POST https://mps.tencentcloudapi.com \
-H "X-TC-Action: CreateAigcVideoTask" \
-H "Content-Type: application/json" \
-H "X-TC-Version: 2019-06-12" \
-H "X-TC-Region: ap-guangzhou" \
-H "Authorization: TC3-HMAC-SHA256 Credential=<SecretId>/<Date>/mps/tc3_request, SignedHeaders=content-type;host, Signature=<Signature>" \
-d '{
"ModelName": "Kling",
"ModelVersion": "3.0",
"SceneType": "lip_sync",
"ImageUrl": "https://<cdn>/portrait.png",
"AdditionalParameters": "{\"session_id\":\"<session-id>\",\"face_choose\":\"<face-id>\"}",
"Operator": "admin"
}'数字人 (avatar_i2v)
用人物图片和音频文件生成说话视频。指定 SceneType=avatar_i2v,图片通过 ImageInfos.N 的 Category=Image 传递,音频通过 AdditionalParameters 的 sound_file 传递。音频支持 mp3、wav、m4a、aac,不超过 5MB,范围在 2~300 秒 之内。与版本无关。
{
"ModelName": "Kling",
"ModelVersion": "3.0",
"SceneType": "avatar_i2v",
"Prompt": "a digital human talking",
"ImageInfos": [
{
"Category": "Image",
"Url": "https://<cdn>/avatar.png"
}
],
"AdditionalParameters": "{\"sound_file\":\"https://<cdn>/voice.mp3\"}",
"Duration": 5,
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"EnhancePrompt": false
}多镜头(故事板)
在 3.0 系列中可用单个任务生成多个镜头。在 AdditionalParameters 中指定 multi_shot / shot_type / multi_prompt。
{
"ModelName": "Kling",
"ModelVersion": "3.0",
"Prompt": "a short cinematic sequence in three shots",
"Duration": 15,
"AdditionalParameters": "{\"multi_shot\":\"true\"}",
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"EnhancePrompt": false
}自定义音色 (voice_id)
通过自定义音色生成 API 创建音色,并在生成请求的 AdditionalParameters 中用 voice_list 指定 voice_id。2.6 / 3.0 / 3.0-Omni 支持该功能,而 2.6 仅在 1080P 中音色指定才会生效。
{
"ModelName": "Kling",
"ModelVersion": "3.0",
"Prompt": "a narrator introduces the product",
"Duration": 10,
"ExtraParameters": {
"Resolution": "1080P",
"EnableAudio": true
},
"AdditionalParameters": "{\"voice_list\":[{\"voice_id\":\"<voice-id>\"}]}",
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"EnhancePrompt": false
}多元素编辑 (multi_elements)
MPS CreateAigcVideoTask 也支持 SceneType=multi_elements。在 AdditionalParameters 中放入 session_id 与 edit_mode 一并传递。
选择会话仅限 VOD
用于创建选择区域的 InitializeAigcMultiElementsSelection / EditAigcMultiElementsSelection 会话 API 仅限 VOD。因此需先在 VOD 路径下创建选择会话,再将下发的 session_id 用于 MPS 生成请求。整体 3 步流程以及会话 API 的参数,请参考 VOD Kling 文档中的多元素编辑章节。
{
"ModelName": "Kling",
"ModelVersion": "1.6",
"SceneType": "multi_elements",
"Prompt": "重新生成 <<<video_1>>> 中的特定主体",
"Duration": 10,
"AdditionalParameters": "{\"session_id\":\"<session-id>\",\"edit_mode\":\"addition\"}",
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"EnhancePrompt": false
}附加选项
自定义参考对象
Kling 自定义参考对象通过单独的 API 进行创建、查询、删除。使用 CreateKlingCustomElement / CreateAigcCustomElement / DescribeKlingCustomElement / DeleteAigcAdvancedCustomElement,并区分管理国内参考对象库与海外参考对象库。