KI
Kling (可灵) 图像生成 API
AI 图像生成 - 支持文生图、图生图、多图参考、风格迁移、图像扩展。
快速开始
1
从控制台获取 API 密钥2
选择 Kling 图像模型3
发送 POST 请求创建任务4
轮询 GET 请求获取图像结果认证方式
在所有请求中添加 Bearer Token 认证头：
Authorization: Bearer YOUR_API_KEY
可用模型
| 模型 | API 名称 | 支持操作 | 价格 (9折) |
|---|---|---|---|
| Kling V2 | kling-v2 | 文生图 / 图生图 / 多图参考 | 0.076 / 0.151 / 0.302 |
| Kling V2 New | kling-v2-new | 风格迁移 图生图 | 0.151 |
| Kling V2.1 | kling-v2-1 | 文生图 / 多图参考 | 0.076 / 0.302 |
| Kling V3 Image | kling-v3-image | 文生图 / 图生图 (1K/2K) | 0.151 |
| Kling Multi-Image | kling-multi-image | 多图参考 | 0.302 |
| Kling Expand | kling-expand | 图像扩展 | 0.151 |
| Kling Omni-Image | kling-image-o1 | 文生图 / 图像编辑 / 多图输入 (1K/2K) | 1.80 |
定价 (9折)
| 模型 | 操作 | 积分/张 |
|---|---|---|
kling-v2 | 文生图 | 0.076 |
kling-v2 | 图生图 | 0.151 |
kling-v2 | 多图参考 | 0.302 |
kling-v2-new | 风格迁移 图生图 | 0.151 |
kling-v2-1 | 文生图 | 0.076 |
kling-v2-1 | 多图参考 | 0.302 |
kling-v3-image | 文生图 / 图生图 (1K/2K) | 0.151 |
kling-multi-image | 多图参考 | 0.302 |
kling-expand | 图像扩展 | 0.151 |
kling-image-o1 | 文生图 / 图像编辑 / 多图输入 (1K/2K) | 1.80 |
接口端点
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_url必填string
源图片 URL
up_expansion_ratio必填number
向上扩展比例 [0, 2]
down_expansion_ratio必填number
向下扩展比例 [0, 2]
left_expansion_ratio必填number
向左扩展比例 [0, 2]
right_expansion_ratio必填number
向右扩展比例 [0, 2]。总面积不超过原图 3 倍。
promptstring
扩展区域的文本提示
nnumber
生成数量，1-9，默认 1
callback_urlstring
完成后的回调 URL
代码示例
curl -X POST https://apimodels.app/api/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"
}
}任务状态
pending任务已排队，等待处理processing图像生成中completed图像生成成功failed图像生成失败错误码
400请求错误 - 参数缺失或无效401未授权 - API 密钥无效402余额不足 - 积分不够404未找到 - 任务 ID 不存在500服务器内部错误注意事项
- *图像文件保存 7 天，请及时下载
- *所有价格为每张图片价格，总费用需乘以 n
- *prompt 最多支持 2500 个字符
- *多图参考最多支持 4 张主体图片
- *图像扩展总面积不超过原图 3 倍
- *建议每 5-10 秒轮询一次状态
- *kling-v2-new 风格迁移分辨率与输入图片一致