大模型连接问题
先确认当前使用的是 Newton、云端 BYOK 还是本地服务，再查看主模型与回退。三者的登录、余额和地址不同，处理方法也不同。
分三步判断
- 连接本身：是否能访问服务、测试连接是否成功。
- 实际模型：模型 ID 是否存在，账户是否有权限与额度。
- 任务能力：普通回复是否成功，只有工具调用或长任务失败，还是完全不能请求。
开始排查时使用不含私人资料的短消息。记录错误原文、发生时间、服务和模型，不要把所有失败都归因于 API Key。
按错误查看
| 错误或现象 | Newton | BYOK / 本地服务 |
|---|---|---|
| 401 / 未认证 | 重新登录 Mystilink，确认当前账户 | Key 是否有效、是否属于该地址；环境变量能否被应用读取 |
| 403 / 无权限 | 查看账户与模型 访问提示 | 检查模型权限、区域或服务访问限制 |
| 402 / 余额相关 | 核对 Newton 余额与充值订单 | 按实际服务提示检查额度；充值 Newton 不会补充第三方账户 |
| 404 / 找不到模型 | 核对目录是否加载、所选模型是否仍可用 | 核对 API 前缀、协议与模型 ID |
| 429 / 限流 | 等待后再试，查看服务提示 | 区分速率限制、并发与额度，不要连续反复重试 |
| 超时 / 连接拒绝 | 网络与服务状态 | 地址、端口、代理；本地服务器是否已启动 |
| 列表为空但有准确 ID | 核对登录与目录状态 | 服务可能不支持发现；核对后手工填写 ID |
| 测试成功但工具失败 | 记录模型与具体失败步骤 | 检查模型与端点的工具调用、流式输出支持 |
BYOK 地址和 Key
官方 Key 应配官方地址，网关 Key 应配该网关。覆写 Base URL 后，按新服务核对协议与模型 ID；不要把 /chat/completions 或模型网页当成 API 前缀。
使用环境变量时，终端中的变量不一定被已打开的桌面应用读取。确认变量是否对应用进程可用，必要时按当前配置重新启动应用；不要为排查把 Key 粘贴到公开截图或命令日志。
本地模型
确认模型服务器运行、端口正确、模型已加载。localhost 指当前电脑；另一台电脑的 服务应使用其实际可访问地址。普通聊天成功后仍要核对工具调用能力，见 本地部署。
回退与重试
回退只有在候选可用时才可能继续。排查时核对实际被使用的模型，避免把备用服务的错误当成主服务错误。切换服务前确认新的费用与数据去向。
重复点击重试可能增加请求与已完成用量。先确认是否仍在运行、是否等待问询，再决定取消或重试。需要反馈时提供经过遮挡的错误与配置类型，见 联系支持。