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 继续可用。
基本信息
| 项目 | 取值 |
|---|---|
| ModelName | Kling |
| ModelVersion | 4.0 / 4.0-long / 3.0-Omni / 3.0 / O1 / 2.1 |
| 默认值 | ModelVersion=3.0 / AspectRatio=1:1 |
| 护栏解除支持 | 不支持 |
版本差异
| 能力 | 4.0 | 4.0-long | 3.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 | 是 | String | 4.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
| 字段 | 说明 |
|---|---|
Type | File(点播媒体文件)/ Url(可访问 URL)/ Base64 |
FileId | Type=File 时有效 |
Url | Type=Url 时有效 |
Base64 | Type=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
| 字段 | 说明 |
|---|---|
StorageMode | Temporary(临时存储)/ 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.0 | result_type | 否 | single:独立图片;series:关联组图 |
4.0 | series_amount | 否 | 组图张数(result_type=series 时使用,指南示例为 10) |
4.0-long | skill | 是 | 长图技能:ecommerce(电商详情页)/ webpage(网页设计) |
4.0-long | length | 否 | 页面长度,仅 skill=ecommerce 有效:short(约 2~5 个功能页)/ medium(约 6~10 个)/ long(约 11~18 个) |
ExtInfo 是 JSON 字符串,里面的 AdditionalParameters 又是一层 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 / 文生图
{
"SubAppId": 123456789,
"ModelName": "Kling",
"ModelVersion": "4.0",
"Prompt": "generate a car"
}4.0 / 参考图生图(多张独立图)
生成 3 张独立图片,张数由 OutputConfig.OutputImageCount 指定。Prompt 里用 @id1 引用参考图。
{
"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)。
{
"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)。
{
"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 个功能页)。
{
"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 适合需要多参考融合的场景。
{
"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"
}原有版本 / 参考图片请求
{
"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:
{
"Response": {
"RequestId": "<request-id>",
"TaskId": "<sub-app-id>-AigcImageTask-<task-hash>"
}
}用 DescribeTaskDetail 查询该 TaskId;AigcImageTask.Status=FINISH、ErrCode=0 时从 Output.FileInfos 读取结果:
{
"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中的组织方式;依赖前请以实测返回为准。