API 密钥常见问题：校验失败与额度
密钥是自备服务的第一道坎。把最常出现的几种故障列成对照表，照着查就行。
故障对照表
| 现象 | 原因 | 解法 |
|---|---|---|
| 校验显示「密钥无效」 | 复制不全、多了空格、密钥被删 | 重新复制粘贴；去服务商后台确认密钥在役 |
| 校验显示「额度耗尽」 | 免费额度用完或预付费扣光 | 等额度刷新周期，或充值 |
| 校验显示「速率受限」 | 触发服务商限流窗口 | 等窗口过去；回退链会自动切下一家 |
| 校验显示「连接失败」 | 网络不通、服务商不可达 | 查网络与代理；部分地区需自行解决可达性 |
| 状态一直「检查中」 | 网络极慢或服务商接口异常 | 重进设置页触发重新校验 |
| 模型列表是空的 | 校验没通过 | 先解决密钥与网络，列表才刷新 |
状态含义的完整解释见连接校验。
高频疑问
问：密钥存在哪里？安全吗？存在本机应用的加密设置里，不上传；导出设置文件时会包含它，文件自行保管，见设置备份。
问：同一服务商能放两把密钥吗？能，按实例添加即可，各配各的模型，见添加服务。
问：改了密钥要重启吗？不用。输入停顿约 0.8 秒自动重新校验，通过即生效。
问：为什么某服务总在回退时报错？大概率是「重试也救不回来」的错误（无效密钥、额度耗尽）——这类错误会被立即跳过。去服务设置页看它的校验状态，红灯处理掉再回链，见回退链。
问：免费密钥申请哪几家最划算？ Gemini（质量）+ Groq（速度）+ OpenRouter（广度）的零成本组合最常用，见免费密钥渠道。
问：密钥会不会被应用「看到」内容之外的东西？应用只把密钥放进请求头发给对应服务商，不采集、不分析、不转投别家；请求直连服务商，见开源与隐私。
终极排查顺序
- 服务设置页看校验状态（红黄绿一目了然）
- 状态对但聊天失败 → 看回退链里该服务的位置与错误提示
- 全链路失败 → 看是否只剩免费档在扛（免费通道限流）
- 还不行 → 用「手动触发」式思路：新建会话重试，排除单会话上下文超长的问题