外观
疑难杂症
按症状查找。绝大多数问题都出在 Base URL 写法 和 分组与协议不匹配 这两件事上。
鉴权类
报 API_KEY_REQUIRED
原因：请求里没带上 Key。
排查：
bash
curl https://aivisx.link/v1/models \
-H "Authorization: Bearer sk-你的KEY"- 确认
Authorization头存在且格式是Bearer sk-xxx（Bearer和 Key 之间有一个空格） - 确认 Key 前缀是
sk-且完整复制（没有多余空格、换行）
报 401 Unauthorized
原因：Key 无效、已被删除，或环境变量没生效。
排查：
- 到控制台「API Keys」确认这把 Key 存在且状态为启用
- 确认没有把 Key 写错（建议重新复制一次）
- 环境变量场景：关掉终端重开，然后
echo $ANTHROPIC_AUTH_TOKEN确认变量已生效
报 403 Forbidden
原因：分组不允许该操作。最常见的是协议和分组平台不匹配。
对照表：
| 你调用的端点 | 需要的分组平台 |
|---|---|
/v1/messages | claude（Anthropic） |
/v1/chat/completions、/v1/responses | gpt-plus / gpt-pro / 我爱祖国（OpenAI） |
/v1beta/models/... | Google 平台分组 |
/v1/images/* | 含图片能力的分组 |
解决：换一把匹配分组的 Key，或到控制台改 Key 的分组。
404 类
报 404 page not found
原因：Base URL 写错，多拼或少拼了路径段。
这是最高频的错误，两种客户端的规则正好相反：
| 客户端 | 正确写法 | 说明 |
|---|---|---|
| Claude Code | https://aivisx.link | 不带 /v1，它自己拼 |
| Codex CLI | https://aivisx.link/v1 | 带 /v1，这是完整前缀 |
| OpenAI SDK | https://aivisx.link/v1 | 带 /v1 |
| Anthropic SDK | https://aivisx.link | 不带 /v1 |
| Gemini CLI | https://aivisx.link | 不带 /v1beta |
写错时的典型表现：请求变成 /v1/v1/messages，返回 404。
限流类
报 429 Too Many Requests
原因：触发了速率限制或并发限制。
解决：
- 降低请求频率，加退避重试（指数退避，从 1 秒开始）
- 到控制台编辑 Key，提高「并发上限」和「速率限制」
- 如果是批量任务，降低并发数
响应很慢或超时
- 高峰期换用
gpt-pro分组（账号池更优） - 长任务改用异步接口（图片、视频都支持）
- 检查本地网络，而不是只怀疑服务端
客户端类
Claude Code 连不上
逐项检查：
bash
# 1. 变量是否生效
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
# 2. 是不是用错了变量名
# 必须是 ANTHROPIC_AUTH_TOKEN，不是 ANTHROPIC_API_KEY- 确认 Base URL 不带
/v1 - 重启终端
- 用
/status命令查看 Claude Code 当前使用的 API 地址
模型不存在 / model not found
- 模型名拼写要和「模型广场」完全一致（区分大小写和连字符）
- 确认该模型属于你 Key 所在的分组
上下文超限
- 换上下文窗口更大的模型
- Claude Code 里用
/compact压缩历史 - 精简系统提示词和附件内容
网络类
请求超时、连接被重置
bash
curl -v https://aivisx.link/health- 返回
{"status":"ok"}说明服务正常，问题在本地网络 - 检查是否开了代理软件干扰
- 换网络环境测试（如手机热点）
流式输出中断
反向代理层已关闭缓冲，正常情况下不会中断。如果频繁中断：
- 检查本地网络稳定性
- 降低单次请求的输出长度
账户类
余额不足
充值后即可恢复。也可以检查该 Key 是否设置了额度上限。
忘记密码
本站目前未开启自助找回密码，请通过 售前售后 联系客服人工处理。
收不到邮箱验证码
- 翻垃圾邮件文件夹
- 等 60 秒重新发送
- 确认邮箱拼写正确
- 企业邮箱可能拦截外部邮件，换个人邮箱试试
还是解决不了？
带上以下信息联系客服，能大幅加快处理速度：
- 你用的客户端和版本
- 完整的报错信息（截图或文字）
- 你配置的 Base URL
- 出问题的时间点
见 售前售后。