obsidian用插件copilot连接AI失败频频报错该如何操作
对照以下参数,在 Copilot 里填写的内容:
1 Model(模型名称)
· ✅ 正确设置:openrouter/free(有冒号时冒号是英文)
· 先用这个测试,成功后可以再换其他模型
2. Provider(提供商)· 必须选择这个“第三方,OpenAI格式”的选项,OpenRouter 的接口兼容这个格式。
3. Base URL(接口地址)
· 比如:https://openrouter.ai/api/v1请完整复制这行地址,一个字母、一个符号(包括最后的 /v1)都不能错。
4. API Key(密钥)
· ✅ 正确设置:以 sk-or-v1- 开头的字符串
请登录 https://openrouter.ai/官网 → 设置 → API Keys → 复制你的密钥。
以上操作没毛病,最后点击test
换了好几个免费模型都显示测试失败,报错402,401,无CORS等…….

换了两款插件调用模型都未成功,认真填写添加模型后测试不成功我出现的报错是什么意思,如何处理。
1、 402 错误:别怀疑自己的操作了,问题出在账户余额上,不是你填错了密钥或模型名称。这意味着你的 OpenRouter 账户里没钱,可能从来就没充值过。虽然很多模型有免费额度,可能你选的模型需要付费才能调用,免费模型每天的调用次数有50次,在Openrouter的个人中心查看余额是否为负数。像是你拿着有效的身份证进了站,但是发现没买票或者余额不足,被拦住不让上车。
🔧 解决方法一:检查并切换免费模型
这是最快的方法。去插件模型列表里找个带 :free 后缀的模型试试(也就是月大推荐的免费模型)
顺带一提 CORS错误 截图里还提到 “with CORS Error”,这个不用太担心。它通常是因为第一个核心错误(402)触发的连锁反应,等账户余额问题解决后,这个提示一般也会跟着消失。(本人操作调用的是openRouter里的免费模型,并且生成密钥后还未调用过,不存在余额不足,可在网页的个人中心中的“活动”一项查看余额)
2、401 错误:简单来说,就是服务器收到了你的请求,但“不认识”或“不信任”你提供的凭证,所以拒绝了你的访问。就像你坐高铁过闸机时,刷身份证但“机器识别不了”,直接提示“验证失败”,门打不开。这说明你的身份证(API Key)可能是错的、格式不对、或者已经失效了。
✅ 正确设置:以 sk-or-v1- 开头的字符串
· 请登录https://openrouter.ai/官网 → 设置 → API Keys → 复制你的密钥。
1. API Key 无效:这是最常见的原因。比如你复制的时候漏了字母,或者不小心多复制了一个空格。
2. Key 被禁用:可能是你无意中在网页上手动删除了这个 Key,或者触发了某些安全机制导致它失效了。
3. 请求头格式错误:对于某些要求严格的模型(特别是免费模型),如果请求的格式不规范,也会被当作无效请求直接拒绝。
401 其实是个好消息,至少说明网络是通的。核对一下 另外填的那几项,看是不是哪个小细节填错了?
那我啥也没填错,为啥就是测试不成功呢?换了几个插件都不行,考虑到可能不是我填写的配置出错,是其他地方没设置好?干脆卷土重来。
首先把copilot删除(包括API,kay,模型设置),并且在左侧目录的copilot文件夹一并删除,完全退出obsidian应用,重新安装copilot插件
💡 为什么要这样做?只卸载不删文件夹 配置文件残留,重装后问题还在 手动删除 copilot 文件夹不重启 Obsidian 缓存没清空,旧配置可能还在 完全退出后重新打开重装后直接能用 环境干净,从零开始 按正确配置重新填写
卸载插件
↓
删除 copilot 文件夹(在 .obsidian/plugins/ 里)
↓
完全退出 Obsidian
↓
重新打开 Obsidian
↓
重新安装 Copilot 插件
↓
重新填写配置(Provider、Base URL、API Key、Model)
↓
点击 Test 验证 → 成功 ✅

安装好copilot,将红框里的三项放在copilot文件夹里。经过这些步骤,重新进入插件配置添加模型。test测试成功开启AI大门。
小白要走的弯路虽远必达!
夜雨聆风