# 通用信息

## 调用域名

```bash
https://api-beijing.klingai.com
```

💡

**注意**：新系统调用域名已由 [https://api.klingai.com](/content/document-api/external-link-confirm?url=https%3A%2F%2Fapi.klingai.com) 变更为 **[https://api-beijing.klingai.com](/content/document-api/external-link-confirm?url=https%3A%2F%2Fapi-beijing.klingai.com)**。此域名适用于服务器在中国地区的用户。

## 接口鉴权

- Step-1：获取 **AccessKey** \+ **SecretKey**
- Step-2：您每次请求API的时候，需要按照固定加密方法生成 **API Token**  
  - 加密方法：遵循JWT（Json Web Token, RFC 7519）标准  
  - JWT由三个部分组成：Header、Payload、Signature

```python
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视频，轻松解锁大屏高清终端展示、专业商业交付等核心商用场景，助力企业提升内容竞争力。

🌟 亮点与应用场景：

1. **行业级画质，直达商用标准：** 4K画质细节精准还原，直达商用交付/送审标准，无超分损耗，色彩与清晰度均符合行业规范
2. **一键原生4K，高效省成本：** 跳过传统超分环节，毫秒级响应生成，无需专业技术操作，大幅提升商业创作效率、降低时间成本
3. **普惠商用场景：** 顶级4K画质，价格极具竞争力，无需额外投入昂贵第三方工具，轻松实现高质量视频制作

**原生4K·一键直出，赋能广告、影视等商业创作！**

🔗 [点击即刻接入](/content/document-api/apiReference/updateNotice/index.html)