常见错误与排查方法

先记录现象

记录发生时间、客户端版本、请求路径、模型 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 解释为余额不足。

获取支持

通过联系页面提交脱敏信息。其余错误场景还需逐条复现后补充到本页，暂不提供未经验证的状态码映射。