# 故障排查

## 先做四项检查

1. 确认主站可访问：[https://webberai.top](https://webberai.top)。
2. 确认 API Key 来自 [API Keys](https://webberai.top/keys) 页面。
3. 确认 Base URL 没有重复 `/v1`。
4. 确认账号有可用余额，且模型在 [模型广场](https://webberai.top/models) 中可见。

## INVALID_API_KEY

接口返回：

```json
{
  "code": "INVALID_API_KEY",
  "message": "Invalid API key"
}
```

处理方式：

- 重新从 [API Keys](https://webberai.top/keys) 页面复制完整密钥。
- 确认没有把前后空格、换行或引号一起复制进去。
- 如果密钥曾经泄露，删除旧密钥并新建一个。

## 404 Not Found

处理方式：

- 检查地址是否写成了 `/v1/v1`。
- OpenAI 兼容接口应使用 `https://webberai.top/v1`。
- 如果客户端自动拼接 `/v1`，则只填写 `https://webberai.top`。

## 模型不可用

处理方式：

- 到 [模型广场](https://webberai.top/models) 确认可用模型 ID。
- 不要手写不存在的模型名。
- 如果某个模型临时不可用，先切换同类型模型验证客户端配置。

## 余额不足或扣费异常

处理方式：

- 到 [Dashboard](https://webberai.top/dashboard) 查看账户概览。
- 到 [Usage](https://webberai.top/usage) 查看调用记录。
- 到 [Orders](https://webberai.top/orders) 查看订单状态。
- 价格、扣费和余额以站内实时记录为准。

## 客户端没有返回内容

处理方式：

- 开启客户端的请求日志或调试模式。
- 用本文档的 `curl` 示例绕开客户端做一次直接请求。
- 降低上下文长度，先发送一句简单测试消息。
- 确认客户端是否需要代理或系统网络权限。