Kai 中文文档 下载 App

模型服务连接校验状态一览

在服务设置里输入或修改密钥后,应用不是发个「保存成功」就完事,而是真的去服务商那里验证一遍,把结果用状态标出来。看懂这几个状态,接线问题基本不用问人。

七种状态

状态含义怎么处理
检查中正在向服务商验证等一两秒
已连接密钥有效,模型列表已刷新直接挑模型
密钥无效服务商拒绝该密钥核对复制完整性、密钥是否被删
额度耗尽密钥有效但账户没额度了充值或等免费额度刷新
速率受限短时间请求过多被限流稍等再试;回退链会自动跳过
连接失败网络层不通查网络、代理与地区可达性
本地网络访问被拒安卓 17+ 对局域网地址的权限拦截按提示去系统设置授权

校验在输入停顿约 0.8 秒后自动触发,不用手点。打开服务设置页时,也会对全部已配服务重新校验一轮,方便一眼体检。

各家校验方式的差异

两个实用联动

安卓 17 及以上版本对局域网地址(私有 IP、local 域名)有单独的本地网络权限:如果你把自定义接口指向家里局域网里的 Ollama,第一次会弹权限申请,拒绝后状态会停在「本地网络访问被拒」,授权回来后会自动重新校验,见本地模型接入。