跳到内容

Kling ​

更新时间

Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcImageTask

Kling Image 是图片生成模型,支持文生图与参考图生成。2026-11-18 上线的 Kling Image 4.0 提供两个版本:4.0 用于常规图片生成(支持独立多图与关联组图),4.0-long 用于长图生成(电商详情页、网页设计)。原有 3.0-Omni / 3.0 / O1 / 2.1 继续可用。

选版本见版本差异,各版本写法见按版本调用。

基本信息 ​

项目取值
ModelNameKling
ModelVersion4.0 / 4.0-long / 3.0-Omni / 3.0 / O1 / 2.1
默认值ModelVersion=3.0 / AspectRatio=1:1
护栏解除支持不支持

版本差异 ​

能力4.04.0-long3.0-Omni / 3.0 / O1 / 2.1
用途常规图片生成长图生成(电商详情页 / 网页设计)常规图片生成
文生图✅✅✅
参考图生图✅(ReferenceType=refer_image)✅(参考图 / 风格参考图 / 主体参考图)✅
一次多张独立图✅(OutputImageCount 1–9)—✅(OutputImageCount 1–9)
关联组图✅(result_type=series + series_amount)——
长图技能—skill:ecommerce / webpage(必填)—
在 Prompt 中引用参考图✅(@<Id>,如 @id1)✅—

怎么选:

  • 普通出图 / 一次出几张不同结果 → 4.0,用 OutputImageCount 指定张数。
  • 一套彼此关联、风格一致的组图(如同一商品的多角度)→ 4.0 + result_type=series。
  • 电商详情页、网页设计这类竖向长图 → 4.0-long,skill 必填。

原厂文档:图片生成 · 长图生成

「4.0-long 不支持一次多张 / 组图」与「原有版本不支持 @<Id> 引用」是按接入指南的参数说明整理的(指南只给 4.0 列出了 result_type,示例中只有 4.0 系列使用 Id),并非指南明文。

请求参数 ​

参数必填类型说明
SubAppId是Integer点播应用 ID
ModelName是String固定值 Kling
ModelVersion是String4.0(图片生成)/ 4.0-long(长图生成)/ 3.0-Omni / 3.0 / O1 / 2.1
Prompt条件必填String生成提示词。FileInfos 为空时必填。可用 @<Id> 引用 FileInfos 里的图片
FileInfos.N否Array参考图片,字段见下表
OutputConfig否Object输出设置,字段见下表
InputRegion否String输入区域:Mainland(中国大陆)/ Oversea(海外)/ OverseaUSWest(海外-美西)
ExtInfo否String扩展参数。4.0 / 4.0-long 的专属参数放在 AdditionalParameters 里,见下文

FileInfos ​

字段说明
TypeFile(点播媒体文件)/ Url(可访问 URL)/ Base64
FileIdType=File 时有效
UrlType=Url 时有效
Base64Type=Base64 时有效。所有文件合计不超过 7 MB;格式 jpeg / jpg / png / webp;不要带 data:image/jpeg;base64, 前缀
Id图片标识,供 Prompt 中以 @<Id> 引用
ReferenceType图片类型。4.0:refer_image(参考图片)。4.0-long:refer_image(参考图片)/ style_refer_image(风格参考图)/ subject_refer_image(主体参考图)

OutputConfig ​

字段说明
StorageModeTemporary(临时存储)/ Permanent(永久存储,返回 FileId)
Resolution分辨率。指南示例中使用 2K / 4K
AspectRatio宽高比。指南示例中使用 auto / 21:9
OutputImageCount生成张数,Kling 可选 1–9
OutputFormat输出格式 jpeg / png,不填跟随模型默认
InputComplianceCheck是否开启输入内容合规检查:Enabled / Disabled
LogoAdd是否添加图标水印:Enabled / Disabled

指南没有给出 4.0 / 4.0-long 的 Resolution / AspectRatio 完整取值,上表只列出示例中出现过的值;其他取值请先实测确认。

ExtInfo.AdditionalParameters ​

版本参数必填说明
4.0result_type否single:独立图片;series:关联组图
4.0series_amount否组图张数(result_type=series 时使用,指南示例为 10)
4.0-longskill是长图技能:ecommerce(电商详情页)/ webpage(网页设计)
4.0-longlength否页面长度,仅 skill=ecommerce 有效:short(约 2~5 个功能页)/ medium(约 6~10 个)/ long(约 11~18 个)

ExtInfo 是 JSON 字符串,里面的 AdditionalParameters 又是一层 JSON 字符串,所以内层引号要写成 \\\",例如:

json
"ExtInfo": "{\"AdditionalParameters\":\"{\\\"result_type\\\":\\\"series\\\",\\\"series_amount\\\":10}\"}"

按版本调用 ​

版本场景示例
4.0文生图4.0 文生图
4.0参考图生图(多张独立图)4.0 参考图
4.0参考图生组图4.0 组图
4.0-long网页设计长图4.0-long 网页设计
4.0-long电商详情页长图4.0-long 电商详情页
3.0 等原有版本文生 / 参考图原有版本

4.0 / 文生图 ​

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "ModelVersion": "4.0",
  "Prompt": "generate a car"
}

4.0 / 参考图生图(多张独立图) ​

生成 3 张独立图片,张数由 OutputConfig.OutputImageCount 指定。Prompt 里用 @id1 引用参考图。

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "ModelVersion": "4.0",
  "FileInfos": [
    {
      "Type": "Url",
      "Url": "https://<host>/reference.png",
      "Id": "id1"
    }
  ],
  "Prompt": "generate a car in the top of @id1",
  "OutputConfig": {
    "StorageMode": "Temporary",
    "Resolution": "2K",
    "OutputImageCount": 3,
    "AspectRatio": "auto"
  }
}

4.0 / 参考图生组图 ​

生成一套 10 张的关联组图,张数由 AdditionalParameters.series_amount 指定(不是 OutputImageCount)。

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "ModelVersion": "4.0",
  "FileInfos": [
    {
      "Type": "Url",
      "Url": "https://<host>/reference.png",
      "Id": "id1"
    }
  ],
  "Prompt": "generate a car in the top of @id1",
  "OutputConfig": {
    "StorageMode": "Temporary",
    "Resolution": "4K",
    "AspectRatio": "21:9"
  },
  "ExtInfo": "{\"AdditionalParameters\":\"{\\\"result_type\\\":\\\"series\\\",\\\"series_amount\\\":10}\"}"
}

4.0-long / 网页设计 ​

ModelVersion=4.0-long,skill=webpage。下例把参考图作为风格参考图(ReferenceType=style_refer_image)。

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "ModelVersion": "4.0-long",
  "FileInfos": [
    {
      "Type": "Url",
      "Url": "https://<host>/style.png",
      "ReferenceType": "style_refer_image",
      "Id": "id1"
    }
  ],
  "Prompt": "generate a webpage design",
  "OutputConfig": {
    "StorageMode": "Temporary",
    "Resolution": "2K"
  },
  "ExtInfo": "{\"AdditionalParameters\":\"{\\\"skill\\\":\\\"webpage\\\"}\"}"
}

4.0-long / 电商详情页 ​

skill=ecommerce,length=short(约 2~5 个功能页)。

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "ModelVersion": "4.0-long",
  "FileInfos": [
    {
      "Type": "Url",
      "Url": "https://<host>/product.png",
      "Id": "id1"
    }
  ],
  "Prompt": "generate a short ecommerce detail page",
  "OutputConfig": {
    "StorageMode": "Temporary",
    "Resolution": "4K"
  },
  "ExtInfo": "{\"AdditionalParameters\":\"{\\\"skill\\\":\\\"ecommerce\\\",\\\"length\\\":\\\"short\\\"}\"}"
}

直接复制指南示例会失败的两处

接入指南里组图与长图的示例把 SubAppId 写成了 AppId,且 ExtInfo 一行后多了一个尾逗号(不是合法 JSON)。本页示例已改正,请以本页为准。

原有版本 / 文生图 ​

原有 3.0-Omni / 3.0 / O1 / 2.1 支持比例 1:1 / 16:9 / 9:16 / 4:3 / 3:4,OutputImageCount 1–9。3.0-Omni / O1 适合需要多参考融合的场景。

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "ModelVersion": "3.0",
  "Prompt": "a serene japanese garden, soft morning light",
  "OutputConfig": {
    "AspectRatio": "1:1",
    "OutputImageCount": 1,
    "StorageMode": "Temporary"
  },
  "SessionContext": "job-001"
}

原有版本 / 参考图片请求 ​

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "ModelVersion": "3.0",
  "Prompt": "Change the background to a quiet garden; preserve the subject.",
  "OutputConfig": {
    "AspectRatio": "1:1",
    "OutputImageCount": 1,
    "StorageMode": "Temporary"
  },
  "SessionContext": "job-001",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Url": "https://<host>/reference.jpg"
    }
  ]
}

响应示例 ​

创建任务返回 TaskId:

json
{
  "Response": {
    "RequestId": "<request-id>",
    "TaskId": "<sub-app-id>-AigcImageTask-<task-hash>"
  }
}

用 DescribeTaskDetail 查询该 TaskId;AigcImageTask.Status=FINISH、ErrCode=0 时从 Output.FileInfos 读取结果:

json
{
  "AigcImageTask": {
    "Status": "FINISH",
    "ErrCode": 0,
    "Progress": 100,
    "Output": {
      "FileInfos": [
        {
          "FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcImageGenFile.png",
          "ExpireTime": "2026-08-01T10:29:48Z",
          "MetaData": {
            "Width": 1024,
            "Height": 1024,
            "Container": "png"
          }
        }
      ]
    }
  }
}

特殊设置 ​

  • 组图张数用 AdditionalParameters.series_amount,独立多图张数用 OutputConfig.OutputImageCount,两者不要混用。
  • 4.0-long 必须传 skill;length 只在 skill=ecommerce 时生效。
  • ReferenceType 的 style_refer_image / subject_refer_image 只适用于 4.0-long;4.0 只用 refer_image。
  • 指南没有说明 series_amount 的取值范围、4.0-long 的输出尺寸,以及组图在 Output.FileInfos 中的组织方式;依赖前请以实测返回为准。

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