# 常见错误与排查方法

## 先记录现象
记录发生时间、客户端版本、请求路径、模型 ID、HTTP 状态码和错误提示。不要提供完整密钥或包含密码的配置。

## 无密钥：401 / API_KEY_REQUIRED
2026-09-10 的公开实测确认：无密钥访问 `/v1/models`，或 POST 到 `/v1/responses`、`/v1/chat/completions`，返回 401 和 `API_KEY_REQUIRED`。

检查是否正确发送 `Authorization: Bearer YOUR_API_KEY`。客户端有独立 API Key 字段时，只填密钥本身。

## 模型或路径错误
核对基础地址是否为 `https://api.aoxtoken.com/v1`，客户端是否又重复添加了路径。模型 ID 和权限需要用当前密钥查询及调用验证。

## 429 不只有一种原因
限流、并发、额度等情况可能有不同原因。查看具体错误码和消息，再检查相关设置，不要自动把所有 429 解释为余额不足。

## 获取支持
通过[联系页面](https://aoxtoken.com/contact/)提交脱敏信息。其余错误场景还需逐条复现后补充到本页，暂不提供未经验证的状态码映射。