Troubleshooting

gw-link 常见错误与排障清单

绝大多数接入问题来自三类原因：Key、base_url 路径、模型名。先用 /v1/models 验证 Key 与网络，再按错误码对照下面的清单定位。

立即体验 · 查看定价

401 INVALID_API_KEY

Key 错误、已删除或复制不完整；也可能是终端读到了旧的环境变量。重新复制 Key 并打开新终端。

403 INSUFFICIENT_BALANCE / SUBSCRIPTION_NOT_FOUND

余额不足需充值；Key 所属分组是订阅分组但账户没有有效订阅时，需要开通订阅或换用余额分组的 Key。

429 API_KEY_QUOTA_EXHAUSTED

该 Key 设置的额度已用完，可在控制台调高额度或换用其它 Key；短时间请求过多也会返回 429，稍后重试。

404 / 路径错误

Claude Code、Gemini CLI 的 base_url 不要带 /v1；Codex、OpenAI SDK 的 base_url 必须带 /v1。

排障顺序

  1. 运行 curl https://gw-link.com/v1/models 验证 Key 与网络。
  2. 核对 base_url 是否符合所用工具的要求（是否带 /v1）。
  3. 确认模型名出现在 /v1/models 返回的列表中。
  4. 在控制台检查余额、订阅状态与 Key 额度。

配置示例

第一步：验证 Key

返回 JSON 模型列表即 Key 有效；401 为 Key 问题；超时或连接失败为网络问题，可换用 https://gw-link.ai 测试。

curl https://gw-link.com/v1/models \
  -H "Authorization: Bearer sk-你的gw-link密钥"

常见问题

401 一般是什么原因？

通常是 API Key 错误、已删除、复制时缺了字符，或工具读取了旧的环境变量。gw-link 的 Key 以 sk- 开头。

提示模型不存在怎么办？

模型名必须出现在 Key 所属分组的可用模型中，调用 /v1/models 查看准确的模型 ID，并检查工具里配置的模型名是否拼写一致。

返回 503 是什么意思？

表示网关或上游暂时繁忙，属于临时性错误，稍后重试即可；持续出现请联系客服。

Claude Code 报 404？

多半是 ANTHROPIC_BASE_URL 写成了 https://gw-link.com/v1，导致请求变成 /v1/v1/messages。改为 https://gw-link.com。

English

最后更新: