06 FAQ API

Jump to bottom

jialm edited this page May 10, 2026 · 1 revision

6.2 API 连接问题

症状

底部状态栏显示 "未连接到 API!"
发送消息后无响应
提示连接超时或网络错误

排查步骤

1. 确认 API 配置

在酒馆 Web 界面 → API 连接 中检查：

API 类型选择正确（OpenAI / Claude / 自定义等）
API 地址填写正确
API 密钥填写正确且未过期

2. 检查网络连接

SillyDroid 是本地服务，但 API 调用仍需外网连接
确认手机可以正常访问互联网
如果使用代理/VPN，确认代理设置正确

3. 检查 API 服务可用性

访问 API 提供商的状态页面确认服务正常
检查 API 配额是否已用尽

4. 检查配置文件

如果手动编辑过 config.yaml：

设置 → 配置 Tab
检查 API 相关配置项
确认没有语法错误（YAML 缩进敏感）

使用本地模型

如果使用本地部署的模型（如 Ollama、text-generation-webui）：

确保本地模型服务在运行
API 地址填写为 http://<电脑IP>:<端口>
手机和电脑在同一局域网内
确认电脑防火墙允许对应端口入站

使用代理

如果通过代理连接 API：

在 config.yaml 中配置代理
或使用系统级代理（如 Clash、V2Ray）
注意代理规则是否覆盖 API 域名