大模型连接问题
测试连接失败
- 打开 设置 → 大模型，编辑对应配置，点击 测试连接。
- 确认 API Key 为有效字面值，或环境变量名在本机已
export。 - 若使用覆写 Base URL，检查是否多写路径、是否需代理。
- 公司网络是否拦截对
api.openai.com等域名的访问。
常见错误
| 现象 | 处理 |
|---|---|
| 401 / Invalid API Key | BYOK：重新生成 Key 并更新配置；Newton：重新登录账户 |
| 402 / 余额不足 | Newton：前往 控制台 或 充值 |
| 404 / model not found | 核对模型 ID 拼写与账号权限；Newton 确认模型列表已刷新 |
| 429 / rate limit | 降低并发或更换厂商 / 模型 |
| 超时 / 服务不可用 | 检查网络、代理、Base URL；Newton 可稍后重试或临时改用 BYOK |
Newton 专用排查
- 确认桌面端已 登录 Mystilink 账户（非仅粘贴激活码）。
- 会话过期时重新登录后再拉模型列表。
- 余额为 0 或不足时先充值，见 Newton 计费。
- 使用说明见 Newton LLM。
主模型不可用
若已开启 自动回退，确认至少有两条可用配置。否则临时将另一条设为 主模型（可在 Newton 与 BYOK 之间切换）。
密钥安全
- 勿将 BYOK Key 或账户凭证提交到 Git 或截图外传。
- Mystilink 不会把你的 BYOK Key 上传到服务器；BYOK 请求直连厂商。
- 不要把账户登录令牌当作可分享的「API Key」。
更多说明：Newton LLM、大模型与厂商、官方平台 API Key 配置、OpenAI 兼容供应商配置、本地大模型部署配置、FAQ：大模型与隐私。