通用信息
调用域名
https://api-beijing.klingai.com
💡
注意:新系统调用域名已由 https://api.klingai.com 变更为 https://api-beijing.klingai.com。此域名适用于服务器在中国地区的用户。
接口鉴权
- Step-1:获取 AccessKey + SecretKey
- Step-2:您每次请求API的时候,需要按照固定加密方法生成 API Token
- 加密方法:遵循JWT(Json Web Token, RFC 7519)标准
- JWT由三个部分组成:Header、Payload、Signature
import time
import jwt
ek = "" # 填写access key
sk = "" # 填写secret key
def encode_jwt_token(ak, sk):
headers = {
"alg": "HS256",
"typ": "JWT"
}
payload = {
"iss": ak,
"exp": int(time.time()) + 1800, # 有效时间,此处示例代表当前时间+1800s(30min)
"nbf": int(time.time()) - 5 # 开始生效的时间,此处示例代表当前时间-5秒
}
token = jwt.encode(payload, sk, headers=headers)
return token
api_token = encode_jwt_token(ak, sk)
print(api_token) # 打印生成的API_TOKEN
- Step-3:用第二步生成的API Token组装成 Authorization,填写到 Request Header 里
- 组装方式: Authorization = “Bearer XXX”, 其中XXX填写第二步生成的API Token(注意Bearer跟XXX之间有空格)
错误码
| 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 | 内部错误 | 服务器内部超时,通常是发生积压 | 稍后重试,或联系客服 |
可灵视频3.0系列模型再次迎来升级,支持一键生成原生4K视频,轻松解锁大屏高清终端展示、专业商业交付等核心商用场景,助力企业提升内容竞争力。
🌟 亮点与应用场景:
- 行业级画质,直达商用标准: 4K画质细节精准还原,直达商用交付/送审标准,无超分损耗,色彩与清晰度均符合行业规范
- 一键原生4K,高效省成本: 跳过传统超分环节,毫秒级响应生成,无需专业技术操作,大幅提升商业创作效率、降低时间成本
- 普惠商用场景: 顶级4K画质,价格极具竞争力,无需额外投入昂贵第三方工具,轻松实现高质量视频制作
原生4K·一键直出,赋能广告、影视等商业创作!
🔗 点击即刻接入