跳到内容

Kling ​

更新时间

Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask

Kling 是功能最全面的视频生成模型之一,支持文生视频、首帧 / 首尾帧生视频,以及图片、视频的多模态参考生成。3.0-Omni / O1 支持多镜头(智能分镜)与视频编辑,并提供动作控制、口型同步、数字人、自定义音色等扩展能力,可同时生成音频。

基本信息 ​

项目值
ModelNameKling
ModelVersion4.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选填String4.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选填BooleanPrompt 自动校正。默认值 false
ImageUrl选填String首帧图片 URL。必须可从外部访问且不超过 10MB
LastImageUrl选填String尾帧图片 URL。需与 ImageUrl 一起使用
ImageInfos.N选填Array参考图片数组。如 Category / Url / ReferenceType 等
Duration选填Integer生成时长(秒)。仅生效各模型允许的值
ExtraParameters选填ObjectResolution / AspectRatio / EnableAudio
AdditionalParameters选填String承载模型专属选项的 JSON 字符串。seed 的传递格式请参考 附加配置
SceneType选填Stringmotion_control(动作控制)、lip_sync(口型同步)、avatar_i2v(数字人)、multi_elements(多元素编辑)
ExtraParameters.
EnablelnputComplianceCheck
选填Boolean显式传递 false 则解除输入审核。使用前请咨询商务负责人
ExtraParameters.
EnableOutputComplianceCheck
选填Boolean显式传递 false 则解除输出审核。使用前请咨询商务负责人

请求示例 ​

text-to-video ​

文本生成需输入 Prompt,并通过 ExtraParameters 指定分辨率 / 宽高比 / 音频同步生成。

json
{
  "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
}

响应示例 ​

json
{
  "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.EnablelnputComplianceCheckfalse解除输入审核
ExtraParameters.EnableOutputComplianceCheckfalse解除输出审核

将以下配置合并到现有生成请求中。如需同时解除输入和输出审核,请一并传递这两个字段。

json
{
  "ExtraParameters": {
    "EnablelnputComplianceCheck": false,
    "EnableOutputComplianceCheck": false
  }
}

各版本支持能力 ​

版本生成模式最大参考图片音频时长
3.0-Omnitext / image / 参考生成8 张原声、配音、音效3~15 秒
3.0text / image6 张支持3~15 秒
O1text / image / 参考生成4 张支持3~10 秒
2.6text / image4 张仅在参考生成 + pro 模式(1080P)下支持5 秒,10 秒
2.1 / 2.0 / 1.6text,默认 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.0text / image(文生 / 图生视频)10 张3~30 秒
  • 4.0:面向文生视频与图生视频(首帧 / 首尾帧)的通用生成。
  • 4.0-Omni:面向视频参考生视频(以参考视频驱动生成),参考素材走 ImageInfos.N / 参考视频信息字段。

调用示例(text-to-video,4.0) ​

下方 JSON 中的 Prompt、Duration、分辨率、CosBucketName 等均为示例 / 参考值,实际请以你的业务参数与真实数据为准。

json
{
  "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 等为示例 / 参考值,实际以真实素材与业务参数为准。

bash
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 中支持。

json
{
  "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 张。

json
{
  "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。

json
{
  "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。与版本无关,填入任意值均可生效。

bash
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"
}'
bash
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 秒 之内。与版本无关。

json
{
  "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。

json
{
  "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 中音色指定才会生效。

json
{
  "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 文档中的多元素编辑章节。

json
{
  "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,并区分管理国内参考对象库与海外参考对象库。

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages