🎉 可灵AI 原生4K直出，现已开放API！支持V3系列模型 🎉
可灵视频3.0系列模型再次迎来升级，支持一键生成原生4K视频，轻松解锁大屏高清终端展示、专业商业交付等核心商用场景，助力企业提升内容竞争力。
🌟 亮点与应用场景：
- 行业级画质，直达商用标准： 4K画质细节精准还原，直达商用交付/送审标准，无超分损耗，色彩与清晰度均符合行业规范
- 一键原生4K，高效省成本： 跳过传统超分环节，毫秒级响应生成，无需专业技术操作，大幅提升商业创作效率、降低时间成本
- 普惠商用场景： 顶级4K画质，价格极具竞争力，无需额外投入昂贵第三方工具，轻松实现高质量视频制作
原生4K·一键直出，赋能广告、影视等商业创作！
创建任务
POST/v1/images/generations
cURL
curl --request POST \
--url https://api-beijing.klingai.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model_name": "kling-v2-1",
"prompt": "生成皮克斯风格的小狗",
"negative_prompt": "",
"image": "https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog.png",
"n": 2,
"external_task_id": "",
"callback_url": ""
}'
200
{
"code": 0, // 错误码；具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID，系统生成，用于跟踪请求、排查问题
"data": {
"task_id": "string", // 任务ID，系统生成
"task_status": "string", // 任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
"task_info": { // 任务创建时的参数信息
"external_task_id": "string" // 客户自定义任务ID
},
"created_at": 1722769557708, // 任务创建时间，Unix时间戳、单位ms
"updated_at": 1722769557708 // 任务更新时间，Unix时间戳、单位ms
}
}
💡
请您注意，为了保持命名统一，原 model 字段变更为 model_name字段，未来请您使用该字段来指定需要调用的模型版本。
同时，我们保持了行为上的向前兼容，如您继续使用原 model字段，不会对接口调用有任何影响、不会有任何异常，等价于 model_name为空时的默认行为（即调用V1模型）。
请求头
- Content-Type string 必填 默认值 application/json
- Authorization string 必填 鉴权信息，参考接口鉴权
请求体
- model_name string 可选 默认值 kling-v1
- prompt string 必填 正向文本提示词
- negative_prompt string 可选 负向文本提示词
image string 可选 参考图像
- 支持传入图片 Base64 编码或图片 URL（确保可访问）
images string 可选 参考图像
- 支持传入图片 Base64 编码或图片 URL（确保可访问）
- 图片格式支持 .jpg / .jpeg / .png
- 图片文件大小不能超过 10MB，图片宽高尺寸不能小于 300px，图片宽高比介于 1:2.5 ~ 2.5:1 之间
其他 API
查询任务（单个）
GET/v1/images/generations/{id}
cURL
curl --request GET \
--url https://api-beijing.klingai.com/v1/images/generations/{id} \
--header 'Authorization: Bearer <token>'
200
{
"code": 0, // 错误码；具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID，系统生成，用于跟踪请求、排查问题
"data": {
"task_id": "string", // 任务ID，系统生成
"task_status": "string", // 任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
"task_status_msg": "string", // 任务状态信息，当任务失败时展示失败原因（如触发平台的内容风控等）
"final_unit_deduction": "string", // 任务最终扣减积分数值
"watermark_info": {
"enabled": boolean
},
"task_info": { // 任务创建时的参数信息
"external_task_id": "string" // 客户自定义任务ID
},
"created_at": 1722769557708, // 任务创建时间，Unix时间戳、单位ms
"updated_at": 1722769557708, // 任务更新时间，Unix时间戳、单位ms
"task_result": {
"images": [
{
"index": 0, // 图片编号，0-9
"url": "string", // 生成图片的URL
"watermark_url": "string" // 含水印图片下载URL
}
]
}
}
}
查询任务（列表）
GET/v1/images/generations
cURL
curl --request GET \
--url 'https://api-beijing.klingai.com/v1/images/generations?pageNum=1&pageSize=30' \
--header 'Authorization: Bearer <token>'
200
{
"code": 0, // 错误码；具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID，系统生成，用于跟踪请求、排查问题
"data": [
{
"task_id": "string", // 任务ID，系统生成
"task_status": "string", // 任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
"task_status_msg": "string", // 任务状态信息，当任务失败时展示失败原因（如触发平台的内容风控等）
"final_unit_deduction": "string", // 任务最终扣减积分数值
"watermark_info": {
"enabled": boolean
},
"task_info": { // 任务创建时的参数信息
"external_task_id": "string" // 客户自定义任务ID
},
"created_at": 1722769557708, // 任务创建时间，Unix时间戳、单位ms
"updated_at": 1722769557708, // 任务更新时间，Unix时间戳、单位ms
"task_result": {
"images": [
{
"index": 0, // 图片编号，0-9
"url": "string", // 生成图片的URL
"watermark_url": "string" // 含水印图片下载URL
}
]
}
}
]
}
请求头
- Content-Type string 必填 默认值 application/json
- Authorization string 必填 鉴权信息，参考接口鉴权
查询参数
- pageNum int 可选 默认值 1
- pageSize int 可选 默认值 30