报错了，按这张表排查
常见登录、密钥、模型、限流和扣费问题，先做最少的检查。
软件调用报错#
| 提示或现象 | 可能的原因 | 先做什么 |
|---|---|---|
| 401、无效 API Key | 密钥填错、失效、过期或被停用 | 从归壹重新复制完整密钥，核对有效期，不要填写登录密码 |
| 403、没有权限 | 分组、模型或账号访问权限不满足 | 核对密钥分组和模型广场信息，仍不明确时联系支持 |
| 404、接口不存在 | Base URL 或请求路径错误 | 按 Agent 核对地址：Claude Code 根地址，Codex /v1；排除 /v1/v1 或重复完整接口路径 |
| 429、请求过于频繁 | 触发请求限制或服务容量限制 | 按页面提示或 Retry-After 等待，暂停自动重试和并发任务 |
| 额度不足或余额不足 | 账号余额或单枚密钥额度不足 | 分别查看钱包余额与密钥额度，充值不能代替调整已用尽的密钥额度 |
| 模型不存在、没有可用渠道 | 型号拼写、分组权限或模型当前状态不符 | 从模型广场复制完整型号，核对分组，勿随机改后缀尝试 |
| 超时、5xx、连接中断 | 网络、软件或服务链路暂时异常 | 先查看日志，保留错误与请求标识，再稍后少量重试或联系支持 |
登录和账号问题#
| 看到什么 | 怎么处理 |
|---|---|
| 邮箱地址已被占用 | 停止新注册。先登录原账号；需要新增扫码方式时，从原账号的安全与访问发起绑定。 |
| 换电脑后扫码进了别的账号 | 核对是否使用同一个微信或支付宝、之前是否解绑。不要继续充值或更改邮箱，联系支持核对。 |
| 登录页提示操作频繁 | 停止反复刷新、扫码或发送验证码，等待限制恢复后再试。 |
| 刚绑定后仍显示未绑定 | 刷新归壹安全与访问页面；若仍异常，保留发生时间与提示，不要不断重复绑定。 |
费用看起来不对#
先查看日志中的模型、时间、输入量、输出量和扣额，再与当前计费说明比较。长对话会携带历史内容；部分模型还会产生思考用量。不能只根据屏幕上显示的回复字数判断费用。
如果日志和预期仍对不上，请保留对应记录并联系支持核对。不要把完整 API 密钥、客户正文或含个人信息的文档一并发出。