连接问题排查

请按顺序检查,每次只修改一项设置。

1. 检查 API Key

  • 删除前后空格。
  • 确认 Key 已启用、未过期且有剩余额度。
  • 确认进程可以读取设置的环境变量。
  • 不要在日志或支持消息中粘贴完整 Key。

2. 检查协议和 URL

协议Base URL客户端添加的路径
Chat Completionshttps://getrouter.ai/v1/chat/completions
Responseshttps://getrouter.ai/v1/responses
Claude Messageshttps://getrouter.ai/v1/messages
Geminihttps://getrouter.ai/v1beta/models/...

404 经常由客户端重复添加 /v1 或 Endpoint 导致。

3. 检查模型

  • 模型页面复制准确模型 ID。
  • 确认 Key 有权限使用该模型。
  • 确认模型支持当前协议和功能。
  • 如果工具无法加载模型列表,请手动填写模型 ID。

4. 常见状态码

状态码优先检查
400不支持的字段、无效请求或功能不匹配
401API Key 缺失或无效
403Key、模型、分组或策略限制
404URL/路径错误或模型不存在
429余额、额度、并发或速率限制
5xx临时上游或网关错误

5. 最小化测试

先关闭 Tool、文件、图片、长上下文、JSON Mode 和自定义推理设置,只发送一条短文本。成功后再逐项恢复高级功能。

安全求助

请提供工具与版本、协议、模型 ID、脱敏后的 Base URL 配置、HTTP 状态码、错误文本、Request ID,以及包含时区的时间。不要提供完整 API Key。