答疑 / 常见问题
按错误类型快速定位。仍无法解决时,请登录控制台核对余额、密钥状态与请求日志。
网络与上游连接
请求超时、连接被重置或 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」开关打开后才生效。