API 401 Unauthorized 报错怎么排查：API Key、权限和模型范围

API 401 Unauthorized 报错怎么排查：API Key、权限和模型范围，从错误含义、常见原因、排查顺序和 LondAI 平台设置四个角度整理，帮助开发者快速恢复 API 调用。

先判断错误来自哪一层

API 401 Unauthorized 报错怎么排查：API Key、权限和模型范围 不能只看状态码本身。一次 API 调用会经过客户端、LondAI 网关、用户 Key 权限、余额、模型配置、上游渠道和模型供应商，任何一层异常都可能返回错误。

排查时先确认请求地址、Authorization Bearer、模型名和余额，再看渠道测试结果与上游返回信息。

401、429、502、503 的处理思路

401 通常和 API Key、登录态、权限范围有关；429 多数是频率、并发、额度或上游限流；502 和 503 更多指向上游不可用、网关超时、模型暂时不可达。

不要一上来就换 Key。先用用户后台自检中心测试同一个 Key，再用管理后台渠道测试判断上游是否正常。

LondAI 后台应该检查什么

管理员要检查账号管理里的上游 Key 是否有效，渠道分组是否匹配用户分组，模型配置是否包含用户请求的模型名，价格配置是否存在有效倍率。

如果后台测试成功但用户端失败，重点看用户 Key 的模型范围、余额和分组权限。

如何降低再次发生的概率

给高频接口设置合理并发，给高价模型设置单独权限，给渠道配置备用上游，并把失败原因写入使用记录。用户看到可读错误，比只看到 unknown error 更容易自助解决。

教程页面可以把常见错误和对应动作写成表格，减少重复售后。