答疑 / 常见问题

按错误类型快速定位。仍无法解决时,请登录控制台核对余额、密钥状态与请求日志。

网络与上游连接

请求超时、连接被重置或 DNS 解析失败
  • 确认本机能访问 https://api.sshgoodapi.cc(浏览器或 curl)。
  • 检查代理 / VPN / 公司防火墙是否拦截出站 HTTPS。
  • 核对客户端是否写错域名、多了空格或错误协议。
  • 仅个别时段失败时,可稍后重试。
502 / 上游暂时不可用
  • 等待数十秒后重试,避免密集连打。
  • 换同系列另一模型,确认是否单模型问题。
  • 持续出现时查看控制台公告或状态说明。
TLS / 证书错误

请确认系统时间正确,且未使用过期的抓包证书。企业 MITM 代理需正确安装根证书。

鉴权与权限

401 Unauthorized
  • Key 是否完整复制(含前缀),有无首尾空格/换行。
  • Header 是否为 Authorization: Bearer sk-...。
  • Claude Code 是否设置了 ANTHROPIC_AUTH_TOKEN 而非只设置了别的变量名。
  • Key 是否已在控制台被吊销。
403 / 模型不可用

账号可能未开通该模型。请在控制台查看可见的 ID,或参考 模型 API 中的 GET /v1/models,并检查套餐范围。

并发、限流与客户端路径

429 Too Many Requests
  • 降低并行请求数,增加重试间隔(指数退避)。
  • 长任务改为流式或拆分批次。
  • 多设备共用同一 Key 时注意合计 QPS。
Claude Code 正常但 OpenAI SDK 404

Claude Code 使用 Anthropic 风格 Base URL https://api.sshgoodapi.cc(通常不加 /v1)。OpenAI SDK / 多数聊天客户端应使用 https://api.sshgoodapi.cc/v1。

IDE 读不到环境变量

从 Dock / 开始菜单启动的 GUI 应用不一定继承 shell profile。请写入用户级环境变量,或从已配置的终端启动编辑器,然后完全重启应用。

桌面客户端一直连官方地址

确认自定义供应商已保存且被当前会话选中;部分软件需在「启用自定义 API」开关打开后才生效。