模型服务连接校验状态一览
在服务设置里输入或修改密钥后,应用不是发个「保存成功」就完事,而是真的去服务商那里验证一遍,把结果用状态标出来。看懂这几个状态,接线问题基本不用问人。
七种状态
| 状态 | 含义 | 怎么处理 |
|---|---|---|
| 检查中 | 正在向服务商验证 | 等一两秒 |
| 已连接 | 密钥有效,模型列表已刷新 | 直接挑模型 |
| 密钥无效 | 服务商拒绝该密钥 | 核对复制完整性、密钥是否被删 |
| 额度耗尽 | 密钥有效但账户没额度了 | 充值或等免费额度刷新 |
| 速率受限 | 短时间请求过多被限流 | 稍等再试;回退链会自动跳过 |
| 连接失败 | 网络层不通 | 查网络、代理与地区可达性 |
| 本地网络访问被拒 | 安卓 17+ 对局域网地址的权限拦截 | 按提示去系统设置授权 |
校验在输入停顿约 0.8 秒后自动触发,不用手点。打开服务设置页时,也会对全部已配服务重新校验一轮,方便一眼体检。
各家校验方式的差异
- 大多数服务:拉一遍模型列表来验密钥,顺带把可选模型带回来
- Perplexity(Sonar):没有需要鉴权的模型列表接口,改用试探性请求验证密钥,再载入内置的模型名单
- Requesty:坏密钥在其模型接口上返回的 错误码 容易被误读成内容审核,因此应用先单独验密钥、再拉列表
两个实用联动
- 校验通过 = 模型列表刷新:服务商上新模型后,重新进一次服务设置页就能拿到新列表
- 与回退链的关系:校验不通过(无效密钥、额度耗尽等)的实例在回退时会被直接跳过,见回退链
安卓 17 及以上版本对局域网地址(私有 IP、local 域名)有单独的本地网络权限:如果你把自定义接口指向家里局域网里的 Ollama,第一次会弹权限申请,拒绝后状态会停在「本地网络访问被拒」,授权回来后会自动重新校验,见本地模型接入。