问题排查
遇到问题时，先按“客户端配置 → API Key 与分组 → 余额和限制 → 账号或共享状态”的顺序排查。不要直接把完整密钥、账号 token 或收款码发到群聊、工单或截图里。
API 调用失败
先保存这些信息：
- 出错时间。
- 使用的客户端，例如 Codex、Claude Code、CC-Switch 或脚本。
- Base URL 和请求路径，例如
/v1/chat/completions。 - API Key 名称或 ID，不要发送完整密钥。
- 状态码、错误信息、请求 ID。
常见方向：
| 现象 | 你可以先检查 |
|---|---|
| 401 | API Key 是否复制完整，Authorization 是否为 Bearer sk-... |
| 403 | 余额、分组权限、Key 限制、账号状态是否正常 |
| 429 | 是否多个客户端共用同一个 Key，并发或频率是否过高 |
| 5xx | 先换分组或稍后重试，再保留请求 ID 联系站点支持 |
更完整的说明见 状态码说明。
客户端配置异常
Codex、Claude Code 或 CC-Switch 接入异常时，按顺序检查：
Base URL 是否为站点地址 https://ai-pixel.online，端点路径是否保持官方格式，例如 /v1/chat/completions。
API Key 是否重新复制过，前后没有空格，没有把登录态 JWT 或账号 token 当成 API Key。
客户端里选择的模型是否属于当前 API Key 可用分组，例如站点文档或模型列表展示的模型。
如果使用 CC-Switch，确认当前启用的是 Pixel API 对应服务，修改配置后完全退出客户端再重新打开。
如果开启了系统代理、终端代理或本地路由模式，先关闭后再测试一次。
“检测站点失败”不一定代表站点不可用，也可能是检测模型、Base URL、本地代理或客户端缓存配置不匹配。
普通用户用量异常
如果余额消耗、限速或模型结果看起来异常，先检查：
- 在“使用记录”里按 API Key、模型、分组和时间段过滤。
- 查看“余额流水”或订阅消耗，确认扣费时间和请求记录是否对应。
- 确认是否有多个客户端、脚本或同事长期共用同一个 Key。
- 如果怀疑 Key 泄漏，立即删除或轮换 Key，再重新配置客户端。
号主账号异常
号主托管账号或共享账号异常时，先从用户侧能看到的状态排查：
- 在“我的账号”查看账号校验状态、最近错误和今日统计。
- 如果账号提示授权失效、
Token revoked或 401，重新授权或重新导入账号。 - 如果共享分组长时间没有收益，确认账号是否已通过公共校验、是否进入共享池、席位和并发是否配置合理。
- 如果频繁 429、403 或连接失败，先降低并发或暂时下架该账号，避免继续触发上游限制。
- 如果代理相关提示异常，确认代理仍可用，再重新测试账号。
账号广场异常
- 无法加入共享账号时，确认 API Key 是否选择了可用分组，余额是否足够。
- 提示席位不足时，说明该共享账号当前可用人数已满，可以换一个账号或稍后再试。
- 推荐结果为空时，放宽模型、时长、预算或平台筛选条件。
- 已结束席位但仍看到消耗时，查看“使用记录”和“余额流水”，确认是否还有未完成请求。
联系站点支持时带什么
遇到文档无法覆盖的问题，可以先查看 联系方式，再联系站点支持。
请尽量一次性提供：
- 出错时间和所在页面。
- API Key 名称或 ID，不要发送完整密钥。
- 使用的客户端、Base URL 和请求路径。
- 状态码、错误信息、请求 ID。
- 使用记录、账号状态或余额流水里的相关截图。
不要发送完整密钥
提供 API Key 名称或 ID 即可定位问题。完整密钥一旦泄露，任何人都可以用它消耗你的余额。