API 错误码说明
调用 Kimi API 时，可能会遇到以下错误码。请结合错误码与说明排查问题。
错误码一览
| 错误码 | 含义 | 处理方式 |
|---|---|---|
| 400 | 请求参数错误（Bad Request） | 请检查请求体格式是否正确，参数名称和类型是否符合文档要求。常见原因包括：JSON 格式错误、缺少必填参数、参数值超出范围。 |
| 401 | 认证失败（Unauthorized） | 请检查 API Key 是否正确、是否已过期或被禁用，并确认请求头中的 Authorization: Bearer <your-api-key> 格式正确。 |
| 403 | 权限不足/余额不足（Forbidden） | 账户余额可能已用尽，请前往控制台充值。也可能是账号受到限制，请联系客服。 |
| 404 | 资源不存在（Not Found） | 请检查请求的 URL 路径和模型名称是否正确，并确认接口地址为 https://klmi.io/v1/...。 |
| 429 | 请求频率超限（Too Many Requests） | 当前请求已超出速率限制。请降低请求频率，采用指数退避重试策略，或联系客服申请提升速率限制。 |
| 500 | 服务器内部错误（Internal Server Error） | 服务端可能出现临时异常，请稍后重试。如果问题持续发生，请联系 [email protected]，并附上 request_id。 |
通用排查建议
- 查看完整错误信息：API 返回的 JSON 响应通常包含
error.message字段，可提供更详细的错误说明。 - 检查 request_id：每次请求返回的
request_id可帮助客服快速定位问题。 - 参考官方文档：请确保调用方式与 platform.kimi.com 文档一致。
- 使用重试机制：对于 429 和 500 错误，建议实现自动重试，并配合指数退避策略。