Kling Image 4.0 API reference (images, sets, long images)
快手可灵 Kling Image 4.0 的接口文档,两个模型名:kling-image-4.0 出单图(一次 1–9 张)或组图(mode series,一次 2–10 张前后连贯的图),文生图或带最多 10 张参考图和具名主体,2K / 4K / 8K;kling-image-4.0-long 每次出一张超长竖图,做网页设计图或电商详情页,1K / 2K。两者都走 POST /v1/images/generations,异步返回 taskId。
认证
所有请求在 Header 携带 API Key:
Authorization: Bearer YOUR_API_KEY价格
和可灵海外版(kling.ai)API 的价目表一致。可灵从 4.0 开始对输入也计费:一次请求的费用 = 张数 × 单张价 + 输入个数 × $0.00314,输入包括参考图、主体、商品图、风格图和主体图。失败的请求不扣费。
| kling-image-4.0 | 每张 | 说明 |
|---|---|---|
| 2K | $0.0628 | 缺省,PNG |
| 4K | $0.0942 | PNG |
| 8K | $0.157 | JPEG |
| 每张参考图 / 每个主体 | +$0.00314 | 例:2K 组图 4 张 + 2 张参考图 = $0.25748 |
| kling-image-4.0-long | 1K | 2K |
|---|---|---|
| 电商详情页 · short(约 2–5 个版块) | $0.2355 | $0.2826 |
| 电商详情页 · medium(约 6–10 个,缺省) | $0.471 | $0.5495 |
| 电商详情页 · long(约 11–18 个) | $0.785 | $0.8635 |
| 网页设计 | $0.5495 | $0.5966 |
| 每张输入图 | +$0.00314 | +$0.00314 |
文生图 · 单图
/v1/images/generations异步:创建返回 taskId,轮询 GET ?task_id= 到 completed,从 resultUrls 取图(n 张就有 n 个链接),或用 callback_url 接 webhook。n 是互相独立的张数,1–9。要印在图上的文字放在引号里。我们 2026 年 11 月 19 日实测这个例子:拿到 2720×1536 的 PNG,用时 51 秒,瓶身「NOIR」一字不差 —— 只是一次请求,不代表典型耗时。没有精确像素尺寸:请用 resolution + aspect_ratio。
# Text-to-image, 2K 16:9 — create returns a taskId, then poll for the result.
curl -X POST https://api.apimodels.app/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-image-4.0",
"prompt": "A faceted glass perfume bottle on wet black slate, soft studio rim light, product photography, the label reads \"NOIR\"",
"resolution": "2K",
"aspect_ratio": "16:9",
"n": 1
}'
# → { "code": 200, "data": { "taskId": "...", "state": "pending", "model": "kling-image-4.0" } }
curl "https://api.apimodels.app/v1/images/generations?task_id=TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"
# → { "code": 200, "data": { "state": "completed", "resultUrls": ["https://r2.apimodels.app/..."] } }组图(series)
mode 传 series,n 填 2–10,出来的是一组前后连贯的图:同一个角色从早到晚、同一件商品的一整套宣传图、一组分镜。不开 series 时 n 最多 9;开了 series 但 n 小于 2 会返回 400。组图按张数计费,4 张 2K 就是 4 × $0.0628。
# A coherent set of 4 at 2K: 4 × $0.0628 = $0.2512
curl -X POST https://api.apimodels.app/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-image-4.0",
"prompt": "The same red-haired girl through one day: breakfast at home, riding a bike to school, painting in class, reading in bed",
"mode": "series",
"n": 4,
"resolution": "2K",
"aspect_ratio": "3:2"
}'参考图与具名主体(elements)
参考图放在 image_urls(也收 image / images),提示词里按顺序写 @image_1、@image_2。主体(elements)是一个名字加同一主体 2–4 张不同角度的照片,提示词里写 @名字,用来让人物、商品或道具在每张图里保持一致。名字 1–20 个字母、数字、下划线或汉字,不能叫 image_1 / object_1 这种,同一请求里不能重名(不分大小写);tag 可选 character、animal、prop、costume、scene、effect、others;description 可选,最多 100 字。参考图和主体加起来最多 10 个,每个另加 $0.00314。提示词写了 @image_3 却只传了 2 张图,会返回 400。试用区只开参考图,主体请用 API。
# Reference images (@image_1) + a named subject (@Mia), 4K: $0.0942 + 2 inputs × $0.00314 = $0.10048
curl -X POST https://api.apimodels.app/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-image-4.0",
"prompt": "@Mia sitting on the sofa from @image_1, holding a cup of tea, warm evening light",
"image_urls": ["https://example.com/living-room.jpg"],
"elements": [
{
"name": "Mia",
"image_urls": ["https://example.com/mia-front.jpg", "https://example.com/mia-side.jpg", "https://example.com/mia-back.jpg"],
"tag": "character",
"description": "young woman, short black hair, green knit sweater"
}
],
"resolution": "4K",
"aspect_ratio": "4:3"
}'长图:电商详情页与网页设计(kling-image-4.0-long)
每次请求出一张超长竖图(n 只能是 1),有两种 skill。ecommerce:image_urls 放 1–3 张商品图(@image_1…),length 选 short(约 2–5 个版块)、medium(约 6–10,缺省)或 long(约 11–18)。webpage:只要提示词,可选 style_image(@style)照着某种风格做、subject_image(@subject)放上要突出的商品或人物。两种 skill 的字段不能混发:webpage 带 image_urls / length,或 ecommerce 带 style_image / subject_image,都返回 400。不写 skill 时,带图按 ecommerce,不带按 webpage。分辨率 1K / 2K(缺省 2K),不能选比例,不支持 mode 和 elements。输入图请用 JPG / PNG,不超过 20 MB,每边最好不小于 300 像素,宽高比 2:5 到 5:2(超出会在生成时失败)。我们 2026 年 11 月 19 日实测 1K 短版电商页:1024×8002,用时 101 秒,有一处标题被截断 —— 图上的文字要校对。
# E-commerce detail page: skill ecommerce + 1-3 product images + length. Short, 1K: $0.2355 + $0.00314
curl -X POST https://api.apimodels.app/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-image-4.0-long",
"skill": "ecommerce",
"prompt": "A product detail page for @image_1, a stainless steel travel mug for commuters: keeps drinks hot for 8 hours, leak-proof lid, fits car cup holders",
"image_urls": ["https://example.com/mug.jpg"],
"length": "short",
"resolution": "1K"
}'
# Webpage design: skill webpage + optional style_image (@style) and subject_image (@subject). 2K: $0.5966 + 2 × $0.00314
curl -X POST https://api.apimodels.app/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-image-4.0-long",
"skill": "webpage",
"prompt": "A landing page for a coffee subscription in the style of @style, with @subject in the hero section",
"style_image": "https://example.com/style.png",
"subject_image": "https://example.com/coffee-bag.png",
"resolution": "2K"
}'参数 · kling-image-4.0
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| model | 是 | string | kling-image-4.0 |
| prompt | 是 | string | 最多 20,000 个字符;要印在图上的文字放在引号里;用 @image_1 / @名字 指代参考图和主体 |
| image_urls / image / images | 否 | string[] / string | 参考图(公网网址或 data URI),与 elements 合计最多 10 个,每个 +$0.00314 |
| elements | 否 | object[] | 具名主体:{ name, image_urls(2–4 张), tag?, description?(≤100 字)};每个 +$0.00314 |
| mode | 否 | string | default(缺省,单图)或 series(组图) |
| n | 否 | integer | 张数:default 下 1–9(缺省 1),series 下 2–10(必填);也收 count / num_images |
| resolution | 否 | string | 2K(缺省)、4K、8K;1K 返回 400 |
| aspect_ratio | 否 | string | auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 |
| callback_url | 否 | string | 任务完成后的 webhook 回调 URL |
参数 · kling-image-4.0-long
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| model | 是 | string | kling-image-4.0-long |
| prompt | 是 | string | 最多 20,000 个字符;用 @image_1… / @style / @subject 指代输入图 |
| skill | 否 | string | ecommerce 或 webpage;不写时带图按 ecommerce,不带按 webpage |
| image_urls / image / images | ecommerce 必填 | string[] | 1–3 张商品图(仅 ecommerce),每张 +$0.00314 |
| length | 否 | string | short / medium(缺省)/ long(仅 ecommerce) |
| style_image | 否 | string | 风格参考图,@style(仅 webpage),+$0.00314 |
| subject_image | 否 | string | 主体图,@subject(仅 webpage),+$0.00314 |
| resolution | 否 | string | 1K 或 2K(缺省) |
| callback_url | 否 | string | 任务完成后的 webhook 回调 URL |
限制
- kling-image-4.0 没有 1K,也不能指定精确像素尺寸(没有 size 宽x高),只有上面九种比例;要 1K 草图或精确尺寸,请用 MiniMax H3 Image 或 MAI Image 2.7。
- 8K 返回 JPEG,2K / 4K 返回 PNG;不支持透明背景、遮罩、seed 和反向提示词。
- 参考图和主体合计最多 10 个;skill、length、style_image、subject_image 只属于长图模型,发给 kling-image-4.0 会返回 400。
- 长图每次 1 张,结果是图片不是 HTML、不分图层,文字事后改不了;超过约 18 个版块的页面要拆成几次请求。
- 出图要等:实测 2K 单图 51 秒、1K 短版长图 101 秒(各一次)。请轮询或用 callback_url,不要用需要几秒内返回的同步调用方式。
不保证每次都成功
提示词或图片可能被内容审核拒绝,输入图可能读不了或宽高比超出范围,也会偶发临时错误。失败的请求不扣费,返回里带失败原因:审核类改提示词或换图再试,临时错误直接重试。结果文件保留 30 天后自动删除,请及时下载或转存。
试一试:Kling Image 4.0 / Kling Image 4.0 Long Image(试用区:单图 / 组图、参考图、2K / 4K / 8K;长图的两种 skill。主体 elements 请用 API)。
常见问题
Kling Image 4.0 怎么出组图?
model 填 kling-image-4.0,传 "mode": "series",n 填 2–10。再加一个主体(一个名字加同一主体 2–4 张照片),提示词里写 @名字,就能让人物或商品在每张图里保持一致。2K 每张 $0.0628,每张参考图或每个主体另加 $0.00314。
怎么做电商详情页长图?
model 填 kling-image-4.0-long,skill 传 "ecommerce",image_urls 放 1–3 张商品图(@image_1…),length 选 short / medium / long,resolution 选 1K 或 2K。1K 短版每页 $0.2355,每张商品图另加 $0.00314。
Kling Image 4.0 有 1K 吗?
kling-image-4.0 没有 1K,只有 2K、4K、8K,传 1K 会返回 400。长图模型 kling-image-4.0-long 有 1K 和 2K。