故障排查

本章节整理了在使用 tokenfor.me 过程中常见的错误现象及排查步骤，建议在联系售后支持前先按本文逐项检查。

基本自检清单

遇到问题时，先快速确认以下几项：

1. API 地址（Base URL）是否正确？
   • 参考「概览」章节中的「API 地址（Base URL）」小节，确认已在工具中使用正确的区域地址
2. API Key 是否有效？
   • 是否完整复制？有无多出空格或缺少字符？
   • 该 Key 是否仍处于「启用」状态，且未被删除？
3. 网络环境是否正常？
   • 本机是否可以正常访问外网？
   • 有无代理、防火墙或公司网络策略拦截？
4. 模型名称是否正确？
   • 是否在控制台的模型路由中已启用？
   • 是否使用了正确的模型标识符？

常见错误及解决办法

1. 认证失败（401 / 403 等）

典型提示：

• Unauthorized
• Invalid API key
• Permission denied

排查步骤：

1. 再次确认是否按照「API 密钥」章节中「API 地址」小节的说明选择了正确的 API 地址。
2. 在控制台的「API 管理 / Keys」中查看该 Key：
   • 状态是否为启用；
   • 是否已过期或被管理员禁用；
3. 重新复制一次 Key，粘贴到客户端配置中，避免手动输入错误；
4. 如怀疑 Key 泄露，建议直接删除旧 Key，创建新 Key 并更新配置。

2. 无法连接 / 超时

典型提示：

• Connection timed out
• Failed to connect to host

排查步骤：

1. 在浏览器中尝试访问你所配置的 API 地址（参考「概览」章节中的「API 地址（Base URL）」小节），查看是否能正常打开（一般会返回一条简短信息或空白页）；
2. 检查本地或服务器上的代理设置、防火墙规则；
3. 对于公司网络环境，确认是否有互联网访问限制，如有需要与网络管理员沟通；
4. 可尝试在不同网络环境（如手机热点）下再次测试，排除本地网络问题。

3. 模型不存在或不支持

典型提示：

• Model not found
• Unsupported model

排查步骤：

1. 在 tokenfor.me 控制台中确认：
   • 对应供应商（如 OpenAI、Anthropic、Gemini）是否已为该 Key 启用；
   • 指定模型是否在支持列表中；
2. 确认在请求中使用的模型名称与控制台建议的一致；
3. 若仍有疑问，可截图控制台配置和请求示例，一并发给售后支持协助核对。

4. 超出配额或限流

典型提示：

• Rate limit exceeded
• Quota exceeded

排查步骤：

1. 在「使用情况 / Usage」中查看近期用量是否异常增高；
2. 检查是否有脚本或程序在短时间内频繁调用；
3. 如为团队或企业环境，确认是否有其他成员在大量使用同一 Key；
4. 如确实业务高峰导致超限，可联系充值或售后支持，评估提升额度或优化调用策略。

收集信息以便求助

若按照以上步骤仍无法解决问题，建议在联系售后支持前准备好如下信息：

• 问题发生的大致时间；
• 使用的工具名称及版本（如 Codex、Claude Code CLI、OpenClaw 等）；
• 所使用的 API Key 标识（避免直接发送完整 Key，可截断或使用备注名称）；
• 请求示例（去除敏感内容后）：
  • 所用模型名称；
  • 关键参数（如温度、最大 tokens 等）；
• 完整的错误信息截图或文本。

携带上述信息可以显著提高排查效率，帮助你更快恢复正常使用。