连接 AI 服务商
预设、密钥、连接测试，以及报错了怎么看。
阅读约 3 分钟
NovelKnow 不绑定任何一家模型厂商 —— 你用自己的 API 密钥，模型选谁、花多少钱都由你决定。
最快的配法
「AI 设置」→ 点一个厂商预设 → 贴密钥 → 「测试连接」→「保存服务商」。
预设会替你填好接口地址、默认模型和上下文窗口。这几项是最容易记错的，也是配不通时最常见的原因。
目前内置的预设：DeepSeek、OpenRouter、OpenAI、Kimi / Moonshot、通义千问 / DashScope、SiliconFlow、本地 Ollama。
任何 OpenAI 兼容的接口都能用，不在预设里的服务商选「自定义」，手填接口地址即可。
模型列表
保存之后可以点「同步模型」，从服务商那边拉真实的模型列表。拉到之后，各处的模型下拉框就是从这个列表里选，不用手打模型名。
常用的几个可以勾成「常用模型」，会排在下拉框前面。
报错了怎么看
连接测试和生成失败的提示里会带上服务商返回的原文，据此判断：
| 报错里出现 | 通常是 |
|---|---|
401 / Incorrect API key | 密钥错了或者过期了 |
404 / model does not exist | 模型名写错了，或者你的账号没有这个模型的权限 |
429 | 触发限流，或者账户余额 / 额度用完了 |
fetch failed / ECONNREFUSED | 网络到不了该服务商，见下面的代理 |
出站代理
如果部署环境访问不了境外服务商，可以在「AI 设置」下方开启出站代理。
注意这个地址是从部署服务器解析的，不是从你自己的电脑。 填 127.0.0.1:7890 只有在服务端本机也跑着代理时才有意义。
你的密钥怎么存的
密钥用你账号派生的密钥加密后存在数据库里，接口返回给浏览器时只返回掩码。你在界面上永远看不到自己贴过的完整密钥 —— 想换就重新贴一遍。