模型无法连接 — 排查清单

Base URL 格式

最常见的问题——Base URL 填多了路径。

✅ 正确：https://api.openai.com/v1 ❌ 错误：https://api.openai.com/v1/chat/completions

Base URL 只填到版本号。接口路径（/chat/completions、/embeddings 等）由 NoteGen 自动拼接。

排查清单

按顺序检查，从上到下逐个排除：

1. Base URL 格式

见上。确保只到版本号。

2. API Key

• 复制粘贴正确，没有多余空格或换行
• 没有过期（服务商控制台检查有效期限）
• 服务商那边 Key 对应的账户有额度/余额

3. 模型名称

• 服务商确实有你填的模型名称（拼错一个字母就不行）
• 模型类型匹配（对话模型用对话模型名，嵌入模型用嵌入模型名）
• 部分服务商免费模型需要单独申请权限

4. 连接检测

NoteGen 模型设置里的连接检测按钮一定要点。它会用简单请求测试：

• 能否访问 Base URL
• Key 是否有效
• 模型名称是否正确
• 服务商是否返回了有效响应

5. 本地模型服务

用 Ollama / LM Studio 等本地模型时：

• 服务是否真的在运行（命令行 ollama list 看有没有模型）
• 监听地址和端口是否正确（Ollama 默认 localhost:11434，LM Studio 默认 1234）
• 服务是否允许 NoteGen 所在设备访问（局域网设备需要特别配置）

6. 代理

• 供应商级代理在设置中可以配：继承系统代理 / 直连 / 自定义
• 确认全局代理地址有效
• 国内访问部分海外模型服务商可能必须走代理

7. 兼容旧接口

部分旧服务商只接受 max_tokens 参数名，NoteGen 默认发 max_completion_tokens。在模型设置里可以切换这个参数名。

常见错误表现

仍未解决

以上都试了还是不行？去 GitHub Issues 搜索类似问题，或提交新 Issue。提供：

• NoteGen 版本
• 系统版本
• 你用的模型服务商和模型名
• 连接检测的报错信息

不要在 Issue 里贴完整 API Key——脱敏后再发。