API 常见问题

先核对四项：KeenKind API Key、服务地址、模型 ID、当前工具版本。保留错误码和发生时间，有请求编号时一起保存。

按错误查原因

现象或错误码	先做什么
401 / 403	检查 Key 是否完整、有效，账户和模型是否有使用权限；网站登录 Cookie 不能替代 API Key
404 / 找不到模型	检查完整请求路径、Base URL 是否重复 /v1，再核对模型目录中的实际 ID
INSUFFICIENT_CREDITS	到余额与充值检查账户可用余额或额度
402 / API_KEY_QUOTA_EXCEEDED	到 API 密钥检查该 Key 的使用上限；账户有余额也可能触发
429 / rate_limit_exceeded	降低并发、等待后再试；响应有 Retry-After 时按提示等待
400 / context_length_exceeded	缩短历史和附件，或降低最大输出，再发送较小任务
400 / 422 参数错误	先恢复工具默认参数，确认模型是否接受思考强度、图片或其他扩展参数
503 / UPSTREAM_AUTHENTICATION_FAILED	联系支持排查服务端通道；无需反复更换自己的有效 Key
503 / UPSTREAM_ENDPOINT_UNAVAILABLE	保存错误码与请求编号，联系支持排查服务端地址

超时、断流或没有完整回答

1. 先打开用量记录，核对对应时间与模型的调用。
2. 查看工具是否仍在执行，避免同时重复提交同一个任务。
3. 保留错误、发生时间和请求编号。无法确认结果时，联系支持核查。
4. 确认可以重试后，再用一个较小任务验证。

连接中断不代表服务端没有执行。已经输出部分内容的请求，可能按已确认的部分用量结算。

能聊天，但不能读取文件或修改代码

先区分模型连接与本地工具执行：

• 确认当前模型和接口支持工具调用。
• 确认已经在编码工具中打开项目，并允许读取相应文件。
• 展开失败的工具调用，检查是模型参数错误，还是本地权限、命令或文件路径错误。
• 先用读取 README 的小任务验证，再尝试修改或长时间运行。

配置后仍走旧服务

确认选择了新建的供应商和模型。使用环境变量配置时，要从设置变量的同一终端启动工具；已经运行的应用通常不会自动获得新终端的环境变量。具体步骤见工具配置。

联系支持时提供什么

从联系入口发送以下信息，能减少来回确认：

工具名称与版本：
操作系统：
发生时间（含时区）：
模型 ID 与协议：
Base URL：
错误状态码 / 错误码：
请求编号（如有）：
复现步骤：

请求编号通常可从响应头 X-Inference-Request-ID 获取；工具没有展示时，提供发生时间即可。发送截图或日志前，移除 API Key、Cookie 和项目中的私密内容。