MineChat 服务商连不上：API Key、网络、限流三个方向

症状

在 MineChat 设置面板里保存了服务商配置，但回首页发消息后一直没有 AI 回复——或者设置里点保存时就提示连接失败。

排查一：API Key 是否正确

这是最常见的原因。检查清单：

• Key 有没有复制完整——开头和结尾不要多复制空格或换行符
• Key 格式对不对——每家服务商的 Key 开头不同（见 API Key 获取），格式不对大概率没复制对
• Key 是否有效——如果确认格式正确但仍无效，可能是 Key 已被撤销或过期。去服务商平台检查 Key 状态，不行就重新生成一个
• 服务商和 Key 是否匹配——不要用 OpenAI 的 Key 去配 Google Gemini 服务商，肯定连不上

排查二：网络状态

MineChat 调用模型 API 需要稳定的网络连接：

• Wi-Fi 和移动数据都试试——有时候某个网络对特定服务商的 API 有屏蔽
• VPN 问题——如果开了 VPN，试试关掉或换节点。有些 VPN 节点可能无法连接到某些服务商的 API 地址
• DNS 问题——尝试切换到公共 DNS（比如 8.8.8.8 或 1.1.1.1）

排查三：服务商限流或故障

五家服务商都有可能临时限流或故障：

快速判断方法：换一家服务商（比如从 OpenAI 切到 Gemini 免费层）测试。如果新服务商能连上，说明原来的服务商有问题——不是你的配置错了。

排查四：模型选择

某些模型可能在你的当前服务商账户上没有权限访问。比如：

• 免费层账户可能用不了某些高级模型
• Claude Opus 需要特定的账户层级

在设置面板里切到一个确定有权限的基础模型（比如 GPT-4o mini、Gemini 2.0 Flash）试试。

还不行

全部排查完都连不上的话，可以：

1. 完全退出 MineChat 再重新打开（有时候配置保存没完全生效）
2. 卸载重装（极端情况）
3. 用另一台手机测试同一份 APK 和同一个 Key