全部文档
当前文档
最近更新时间：2026-06-30 21:56:57
错误码 | 类型 | 核心原因 | 处理建议 |
|---|---|---|---|
401 | 鉴权失败 | 模型名错误 / API Key 无效 | 核对模型名和 Key |
403 | 禁止访问 | URL 转义 / 权限不足 | 使用原始 URL / 检查权限 |
429 | 限流 | 超出 TPM/RPM 配额 | 降并发 + 申请扩容 |
500 | 内部错误 | 服务器异常 | 联系金山云 |
502 | 网关错误 | 节点超时 / 网关过载 | 增大超时，并联系金山云 |
503 | 服务抖动 | 服务抖动 / 负载过高 | 等待几分钟后重试或联系金山云 |
相关报错信息：
{"error":{"type":"Forbidden","message":"unauthorized endpoint"},"type":"error"}排查步骤：
检查权限授权：当前使用的 API Key 不具备该接入点的调用权限，请联系相应管理员在后台添加授权。
检查拼写：检查请求代码中的 API Key 是否填写正确，有无前后空格。
模型名称错误：请求参数中的 model 字段填写有误，请联系相应管理员获取该接入点对应的准确模型标识符。
相关报错信息：
Failed to authenticate. API Error: 403 {"error":{"type":"Forbidden","message":"endpoint 'ep-xxxxx-006ub' is not active"},"type":"error"}Token 达到限额了，需要您联系相应运维或管理人员在额度管理页面，调整在线推理接入点的 Token 额度。
429 Too Many Requests？根本原因：您触发了模型服务商的频率限制（Rate Limits）。通常分为 RPM（每分钟请求数）和 TPM（每分钟 Token 数）两个维度。免费额度或低档位账号极易触发此报错。
解决方案：
相关报错信息：
Error code: 400 - {'error': {'type': 'Bad Request', 'message': 'invalid temperature: only 1 is allowed for this model'}, 'type': 'error'}temperature 参数错误，kimi 官方限制 temperature 强制为 1。
502 Bad Gateway 或 503 Service Unavailable？模型负载压力大，请联系金山云进行处理。
方案 | 说明 |
|---|---|
1. 缩短上下文 | 尽量控制输入 token 数，避免一次性传入过长内容 |
2. 分段处理 | 将长文本拆分为多段，分次调用模型处理 |
3. 精简 Prompt | 去除冗余信息，只保留关键上下文，减少无效 token |
4. 调整采样参数 | 适当降低 temperature（如 0.1-0.3），减少随机性带来的异常输出 |
Prompt is too long / Context length exceeded 怎么处理？这是因为单次输入或累积的对话上下文超过了模型的最大 Token 限制。
Claude Code 用户：输入 /compact 自动压缩并总结上下文，或输入 /clear 彻底清空历史。
通用解法：根据工具提示清理历史、精简单次投喂的代码量，或配置忽略文件（如 .gitignore / .cursorignore）防止工具自动扫描无关的大文件。
如有更大上下文长度要求，请联系金山云进行评估。
在线推理的接入点分配了具体的项目，如果 API Key 不属于该项目，则无法看到，需要新建一个接入点，并将该接入点分配到 API Key 所在项目。
检查项目一致性：确认该 API Key 所属的项目与接入点所属的项目是否完全一致。
数据同步延迟：权限同步需要一定时间，请尝试刷新浏览器或重新登录控制台。
建议使用平台的在线推理功能。通过创建一个推理接入点，将该接入点关联到对应的 API Key 上，即可在接入点维度对 Token 用量进行精细化限制。
请参考文档：在线推理接入点管理。
部署在中国大陆境内的客户端：调用国内版。
部署在海外/国外的客户端：调用国际版。
请检查是否使用了显式缓存（Explicit Cache）功能，显式缓存不能使用免费额度，会直接扣费。
检查您使用的模型是否具备免费额度，请参考模型免费额度说明。
请参考文档进行充值：充值指南。
流式请求（streaming=true）建议 60s 起，长文本（50k+ tokens）建议 300s。
非流式请求建议 180s，长文本建议 300s 以上。
短文本轻量请求 30s 基本足够。
纯净模式