可灵 Kling API 接口错误码说明

概述

本文档列出了调用可灵 Kling API 时可能遇到的错误码及其含义。

每个错误由 HTTP 状态码和业务码共同标识，便于定位问题。

错误码列表

HTTP 状态码	业务码	定义	解释	建议解决方案
200	0	请求成功	-	-
401	1000	身份验证失败	身份验证失败	检查 Authorization 是否正确
401	1001	身份验证失败	Authorization 为空	在 Request Header 中填写正确的 Authorization
401	1002	身份验证失败	Authorization 值非法	在 Request Header 中填写正确的 Authorization
401	1003	身份验证失败	Authorization 未到有效时间	检查 token 的开始生效时间，等待生效或重新签发
401	1004	身份验证失败	Authorization 已失效	检查 token 的有效期，重新签发
429	1100	账户异常	账户异常	检查账户配置信息
429	1101	账户异常	账户欠费（后付费场景）	进行账户充值，确保余额充足
429	1102	账户异常	资源包已用完/已过期（预付费场景）	购买额外的资源包，或开通后付费服务（如有）
403	1103	账户异常	请求的资源无权限，如接口/模型	检查账户权限
400	1200	请求参数非法	请求参数非法	检查请求参数是否正确
400	1201	请求参数非法	参数非法，如 key 写错或 value 非法	参考返回体中 message 字段的具体信息，修改请求参数
404	1202	请求参数非法	请求的 method 无效	查看接口文档，使用正确的 request method
404	1203	请求参数非法	请求的资源不存在，如模型	参考返回体中 message 字段的具体信息，修改请求参数
400	1300	触发策略	触发平台策略	检查是否触发平台策略
400	1301	触发策略	触发平台的内容安全策略	检查输入内容，修改后重新发起请求
429	1302	触发策略	API 请求过快，超过平台速率限制	降低请求频率、稍后重试，或联系客服增加限额
429	1303	触发策略	并发或 QPS 超出预付费资源包限制	降低请求频率、稍后重试，或联系客服增加限额
429	1304	触发策略	触发平台的 IP 白名单策略	联系客服
500	5000	内部错误	服务器内部错误	稍后重试，或联系客服
503	5001	内部错误	服务器暂时不可用，通常是在维护	稍后重试，或联系客服
504	5002	内部错误	服务器内部超时，通常是发生积压	稍后重试，或联系客服

官方文档

https://docs.qingque.cn/d/home/eZQAyImcbaS0fz-8ANjXvU5ed?identityId=1oEG9JKKMFv#section=h.r8ij8wk3sf8p