本文要点
- 401 类错误通常优先检查密钥和权限。
- 429 类错误通常优先检查限速、并发和额度。
- 模型不存在、余额不足和网络失败要分开判断。
步骤一：先判断是身份问题还是网络问题
如果错误提示和密钥、权限、认证有关，先检查 API Key 是否复制完整、是否过期、是否放错项目、是否使用了错误的 Base URL。
如果是连接超时、无法解析、请求中断，先检查本地网络、海外工作台和代理环境。不要在网络不稳定时连续重试，容易把网络问题误判成服务问题。
步骤二：检查额度、限速和模型名
余额不足、套餐到期、模型不支持、并发太高、请求太长，都可能导致失败。中转站还可能把底层错误包装成自己的错误提示。
建议记录每次报错的时间、模型名、接口地址、请求长度、返回错误和扣费情况。没有记录，只凭印象很难判断问题来自哪里。
步骤三：用最小请求复现
排查时先用最小文本、低并发、明确模型名和稳定代理环境测试。最小请求能成功，再逐步增加上下文、工具调用或流式输出。
需要稳定固定出口排查 AI 工具时，可以 访问 PuppyIP 官网；代理配置步骤可查看 使用教程。
常见问题
429 一定是余额不足吗？
不一定。它更常见于限速、并发过高或短时间请求过多，也可能和套餐限制有关。
模型不存在怎么处理？
先确认当前入口支持的模型名，再检查大小写、别名和是否需要在中转后台开启。