Appearance
错误码与排障
出现错误时，先记录 HTTP 状态码、响应中的错误信息、请求时间和请求 ID。请勿公开完整 API 密钥或包含敏感内容的请求体。
常见状态码
| 状态码 | 常见原因 | 处理方式 |
|---|---|---|
400 | 请求体格式错误、缺少必要参数 | 检查 JSON、model、messages 等字段 |
401 | 密钥缺失、无效或已被禁用 | 检查鉴权头与密钥状态，不要重复添加 Bearer |
403 | 当前密钥或分组没有权限 | 确认密钥额度、分组与目标模型权限 |
404 | 地址或接口路径错误 | 检查 Base URL 是否按客户端要求携带 /v1 |
429 | 请求过快、并发受限或上游繁忙 | 降低并发，等待后有限重试，检查余额与限额 |
500 / 502 / 503 | 网关或上游临时异常 | 稍后重试；持续出现时保留请求 ID 联系支持 |
504 | 上游响应超时 | 减少单次任务长度，稍后重试或选择更稳定分组 |
按现象排查
所有请求都返回 401
- 确认请求头格式为
Authorization: Bearer YOUR_API_KEY。 - 环境变量中只保存密钥本身，不包含
Bearer。 - 检查密钥是否被删除、禁用或额度耗尽。
- 新建一个仅用于测试的密钥，判断是配置问题还是原密钥问题。
返回 model not found
从控制台复制准确的模型 ID，不要使用分组名称代替模型名。再确认当前账号或密钥所在分组支持该模型。
Claude Code 返回 404
ANTHROPIC_BASE_URL 应为 https://api.aethesauce.space，不带 /v1。Claude Code 会自行拼接 Messages 接口路径。
Codex 无法连接
检查 Codex 供应商的 base_url 是否为 https://api.aethesauce.space/v1，wire_api 是否与当前调用方式匹配，以及 env_key 指向的环境变量是否已在当前终端设置。
公益分组频繁波动
公益-Grok 是站长自费接入的公益上游，不保证持续稳定。短时异常可以稍后重试；重要任务请直接切换到 Super Grok 或对应的 Pro 池。
不稳定池请求中断
CodexPlus-不稳定 定位为速刷专用。请将任务拆成可恢复的小步骤，并限制自动重试次数；长任务请改用 Codex-Plus 或 CodexPro。
联系支持前准备
提供以下信息可以加快定位：
- 发生时间与时区
- 使用的客户端及版本
- 分组与模型 ID
- HTTP 状态码和完整错误文本
- 请求 ID（如响应中存在）
不要提供完整 API 密钥。需要核对时仅发送密钥的前后少量字符。