KI
Kling (可灵) 图像生成 API
AI 图像生成 - 支持文生图、图生图、多图参考、多图融合、扩图。
快速开始
1
从控制台获取 API 密钥2
选择 Kling 图像模型3
发送 POST 请求创建任务4
轮询 GET 请求获取图像结果认证方式
在所有请求中添加 Bearer Token 认证头:
Authorization: Bearer YOUR_API_KEY
可用模型
| 模型 | API 名称 | 支持操作 | 价格 |
|---|---|---|---|
| Kling V2 | kling-v2 | 文生图 / 图生图 / 多图参考 | $0.0377 / $0.0377 / $0.0754 |
| Kling V3 Omni | kling-v2-new | 多图融合 / 组图 (1K/2K / 4K) | $0.0377 / $0.0754 |
| Kling V2.1 | kling-v2-1 | 文生图 / 图生图 / 多图参考 | $0.0188 / $0.0377 / $0.0754 |
| Kling V3 Image | kling-v3-image | 文生图 / 图生图 (1K/2K) | $0.0377 |
| Kling Multi-Image | kling-multi-image | 多图参考 | $0.0754 |
| Kling Expand | kling-expand | 扩图(出图 1K) | $0.0377 |
| Kling Omni-Image | kling-image-o1 | 文生图 / 图像编辑 / 多图输入 (1K/2K) | $0.0377 |
定价
| 模型 | 操作 | 每张价格 |
|---|---|---|
kling-v2 | 文生图 | $0.0377 |
kling-v2 | 图生图 | $0.0377 |
kling-v2 | 多图参考 | $0.0754 |
kling-v2-new | 多图融合 / 组图 (1K/2K) | $0.0377 |
kling-v2-new | 多图融合 / 组图 (4K) | $0.0754 |
kling-v2-1 | 文生图 | $0.0188 |
kling-v2-1 | 图生图 | $0.0377 |
kling-v2-1 | 多图参考 | $0.0754 |
kling-v3-image | 文生图 / 图生图 (1K/2K) | $0.0377 |
kling-multi-image | 多图参考 | $0.0754 |
kling-expand | 扩图(出图 1K,扩多少同价) | $0.0377 |
kling-image-o1 | 文生图 / 图像编辑 / 多图输入 (1K/2K) | $0.0377 |
接口端点
POST
/api/v1/images/generations创建可灵图像生成任务。根据 model 参数自动路由到文生图、图生图、多图参考、多图融合或扩图。
GET
/api/v1/images/generations?task_id=xxx查询任务状态并获取图像链接
请求参数
文生图 / 图生图
model必填string
"kling-v2"、"kling-v2-1"、"kling-v3-image" 等
prompt必填string
文本提示,最多 2500 字符(文生图必填)
image_urlstring
参考图片 URL(图生图时使用)
negative_promptstring
负面提示词
image_referencestring
"subject" 或 "face"
image_fidelitynumber
图像保真度 [0, 1]
human_fidelitynumber
人物保真度 [0, 1]
resolutionstring
"1k" 或 "2k"
nnumber
生成数量,1-9,默认 1
aspect_ratiostring
"16:9"、"9:16"、"1:1"、"4:3"、"3:4"、"3:2"、"2:3"、"21:9"
callback_urlstring
完成后的回调 URL
多图参考 (kling-multi-image)
model必填string
"kling-multi-image"
multi_model_namestring
"kling-v2" 或 "kling-v2-1",默认 "kling-v2-1"
subject_image_list必填array
{ subject_image: "url" } 数组,最多 4 张
scene_imagestring
场景参考图片 URL
style_imagestring
风格参考图片 URL
promptstring
文本提示
nnumber
生成数量,1-9,默认 1
aspect_ratiostring
"16:9"、"9:16"、"1:1"、"4:3"、"3:4"、"3:2"、"2:3"、"21:9"
callback_urlstring
完成后的回调 URL
扩图 (kling-expand)
model必填string
"kling-expand"
image必填string
原图 URL
up_expansion_rationumber
向上扩多少,按原图高度的比例(0.1 即十分之一),默认 0.1
down_expansion_rationumber
向下扩多少,按原图高度的比例,默认 0.1
left_expansion_rationumber
向左扩多少,按原图宽度的比例,默认 0.1
right_expansion_rationumber
向右扩多少,按原图宽度的比例,默认 0.1
promptstring
描述扩出来的区域应该是什么
nnumber
生成数量,1-9,默认 1
callback_urlstring
完成后的回调 URL
代码示例
curl -X POST https://api.apimodels.app/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-v3-image",
"prompt": "A majestic snow-capped mountain at sunrise with golden light",
"aspect_ratio": "16:9",
"resolution": "2k",
"n": 1
}'响应格式
创建任务响应
{
"code": 200,
"msg": "success",
"data": {
"taskId": "clxxx...",
"state": "pending",
"model": "kling-image-gen/kling-v3"
}
}成功响应
{
"code": 200,
"msg": "success",
"data": {
"taskId": "clxxx...",
"state": "completed",
"model": "kling-image-gen/kling-v3",
"resultUrls": ["https://...image.png"],
"createTime": 1705123450000,
"completeTime": 1705123500000
}
}失败响应
{
"code": 200,
"msg": "success",
"data": {
"taskId": "clxxx...",
"state": "failed",
"model": "kling-image-gen/kling-v3",
"failMsg": "Content policy violation"
}
}回调通知 (callback_url)
在创建请求中传入 callback_url 后,任务进入 completed 或 failed 终态时,我们会向该地址发起一次 HTTP POST。请求头仅包含 Content-Type: application/json,无签名头。失败会自动重试 3 次(指数退避 1s/2s/4s,单次超时 10s);如果仍未成功,后台会在 30 分钟内继续补偿重发,直到接收端返回 2xx。
Payload 结构
POST {your callback_url}
Content-Type: application/json
{
"code": 200,
"msg": "success",
"data": {
"taskId": "clxxx...",
"model": "kling-image-gen/kling-v3",
"state": "completed" | "failed",
"param": "<JSON string>", // request params, JSON.parse once
"resultJson": "<JSON string> | null", // result object, JSON.parse once
"failCode": null | "CONTENT_MODERATION | INVALID_INPUT | INSUFFICIENT_BALANCE | UPSTREAM_BUSY | UPSTREAM_FAILED | TIMEOUT | INTERNAL_ERROR | OTHER",
"failMsg": null | "string",
"retryable": true | false, // present when state=failed: safe to retry/fallback
"costTime": 12345, // duration in ms
"completeTime": 1705123500000, // ms epoch
"createTime": 1705123450000 // ms epoch
}
}注意:data.param 与 data.resultJson 都是 JSON 字符串,使用前必须 JSON.parse 一次。
图像任务:JSON.parse(data.resultJson) 后的结构
{
"resultUrls": [
"https://r2.apimodels.app/images/xxx.png"
]
}resultUrls 为已上传至 Cloudflare R2 的图片 URL 数组,多图运行会返回多张。state=failed 时 resultJson 通常为 null 或 {"resultUrls":[]},请不要假设一定有链接。
Node.js 接收示例
app.post('/webhook/kling-image', express.json(), (req, res) => {
const { taskId, state, resultJson, failMsg } = req.body.data
if (state === 'completed') {
const { resultUrls } = JSON.parse(resultJson)
console.log('image ready', taskId, resultUrls[0])
} else {
console.warn('image failed', taskId, failMsg)
}
res.status(200).end() // must be 2xx, otherwise we retry
})注意事项
- -每个任务只在送达 2xx 后停止重发,已送达后不会重复推送。
- -当前不附带签名头。建议在 callback_url 路径中放置一段随机 token,由你在收到回调时自行校验来源。
- -回调地址建议使用公网 HTTPS 端点,并能在 10 秒内返回响应(单次超时为 10s)。
任务状态
pending任务已排队,等待处理processing图像生成中completed图像生成成功failed图像生成失败错误码
400请求错误 - 参数缺失或无效401未授权 - API 密钥无效402余额不足 - 积分不够404未找到 - 任务 ID 不存在500服务器内部错误注意事项
- *图像文件保存 30 天,请及时下载
- *所有价格为每张图片价格,总费用需乘以 n
- *prompt 最多支持 2500 个字符
- *多图参考最多支持 4 张主体图片
- *kling-expand 只出 1K:返回的是扩展后整张画面缩放到约 1K 的结果,不是原图像素外面再加一圈(实测 1280×720 四边各扩 0.1,返回 1472×832);四个扩展比例不传时各默认 0.1
- *建议每 5-10 秒轮询一次状态
常见问题
Kling 图片 API 怎么用?
调 POST /api/v1/images/generations,选 Kling 模型 + prompt(编辑加参考图),再 GET ?task_id= 轮询。与其它图片模型同端点、同 Key。