Obsidian Copilot 自定义 API 配置

先说结论:Add Custom Model,四个字段

如果还没装,先从 Obsidian 的社区插件里装上 Copilot,打开 Copilot 的设置,进到 Model 标签页。点 Add Custom Model,把表单填好:精确的模型 ID 作为模型名称,Provider 选 3rd party (openai format),Base URL 填 https://api.kkaiapi.com/v1,再填你的 kkaiapi 密钥。 保存前用一下 Verify 按钮:它会发一次真实的测试请求,一个写错的 ID 或 Key 会在这里失败,而不是在对话进行到一半时失败。验证通过之后,这个模型会出现在 Copilot 的模型下拉菜单里,在一个 Claude ID 和一个 DeepSeek ID 之间切换只是选一下下拉菜单,不是重新配置。

模型名称:  claude-sonnet-5
Provider:  3rd party (openai format)
Base URL:  https://api.kkaiapi.com/v1
API Key:   sk-你的kkaiapi密钥

→ 点 Verify,通过后保存

Copilot 怎么用这个模型

Copilot for Obsidian(logancyang/obsidian-copilot,约 7400 星标)是 Obsidian 笔记应用里安装量最大的 AI 插件:在侧边栏和你的笔记对话,跨整个笔记库提问,对选中文字跑命令。这个插件对每个模型条目声明的 Base URL 说标准的 OpenAI chat-completions 格式,这也是为什么任何 OpenAI 兼容端点都能作为一个供应商接进去。 流量形状很特别:笔记库问答会把检索到的笔记片段塞进上下文,所以请求是输入密集型的,一次跨大笔记库的长研究会话会反复发送类似的上下文。这让模型选择成了一个真实的经济决策:日常查笔记用性价比档 ID,难的综合分析用旗舰模型,这个搭配才对,两者配置好之后都在同一个下拉菜单里。 插件自己的说明里有一条机制上的提醒:Obsidian 是 Electron 应用,部分供应商会撞上 CORS 限制。Copilot 给自定义模型提供了一个 CORS 变通开关;如果一个已验证的模型在聊天时报错,先开这个开关再看开发者控制台,别急着断定端点挂了。

给知识笔记库选模型

笔记库问答每次提问都会重发检索到的上下文,所以输入 token 主导账单。网关控制台里按模型的用量视图能精确显示你一周的笔记库工作流在每个 ID 上实际花了多少钱,让旗舰还是性价比的决策变成实证判断,而不是凭感觉。

• claude-haiku-4-5-20251001 用于日常笔记问答:快、便宜,对基于检索的回答来说也够强
• claude-sonnet-5 用于跨多篇笔记的综合、写作辅助,以及任何答案质量本身就是目的的场景
• gpt-5.4-mini 作为 GPT 家族的性价比选择,如果你的提示词和模板是在 OpenAI 的行为习惯上写出来的
• gemini-3.5-flash 适合会话要摄入很长的笔记或转写文本,同时保持中端费率
• deepseek-v4-flash 作为批量操作(比如给一整个文件夹做摘要或打标签)的底价选项

主力模型价格

价格按 kkaiapi 中文区实时价格计算,单位 ¥/1M tokens(输入/输出)。

Obsidian Copilot 专属的翻车点

这个插件更新很频繁,设置页布局也变过,如果这里写的字段名和你的版本对不上,形状是一样的:模型 ID、openai 格式的 Provider、Base URL、Key、Verify。网关这一半随时可以用一条 curl 命令证明是不是它的问题。

• Verify 立刻失败:模型名称和目录 ID 不匹配,或者 Key 错了。用同一个 Key 对 /v1/models 列表跑一次 curl,把 ID 精确复制过来
• 验证通过但聊天报错:通常是 Electron 里的 CORS。在这个自定义模型条目上打开 CORS 变通开关再测一次;开发者控制台(Ctrl+Shift+I)如果是这个原因会显示被拦截的请求
• 答案不理睬你的笔记:那是检索配置的问题,不是模型端点的问题。在怀疑 ID 之前先检查 Copilot 的笔记库问答设置和索引状态
• Embedding 功能失败但聊天正常:Embedding 模型在 Copilot 里是单独配置的,是另一个 API 接口;kkaiapi 目前不提供 Embedding 模型,启用笔记库语义搜索前要单独确认这个 Embedding ID 走的是哪个供应商
• Base URL 带了多余的 /chat/completions:插件自己会拼接路径,只给它以 /v1 结尾的 base,别多写

谁会给 Obsidian Copilot 接一个网关

• 想要 Claude 级别的笔记库问答,又不想开一个 Anthropic 账号的笔记使用者,靠一份预付余额免翻墙起步
• 在大笔记库上跑长问答会话的研究者,输入密集的流量让单价这件事真的重要
• 在性价比 ID 处理日常查询、旗舰模型处理综合分析之间切换的用户,两者都是同一个下拉菜单里的条目
• 已经把编辑器和终端接进网关的人,想让笔记应用也用上同一个 Key 和用量日志
• 想把 AI 流量整合到一个可审计端点的隐私敏感用户,每次请求都能在控制台里查

先验证端点,再在插件里验证

先做两条命令的检查:用 Key 列一次模型,再用你打算添加的精确 ID 发一次补全。两条都通过之后,插件里的 Verify 按钮理应也能通过;如果不能,差距就在表单字段或者 CORS 上,开发者控制台会显示出来。 聊天跑通之后,kkaiapi 控制台会记录每次请求的模型、token 数和花费。一次笔记库会话是很多带着笔记上下文的请求,控制台过滤到你给 Obsidian 用的那个 Key,就是你的第二大脑到底要花多少钱来查阅的诚实记录。

curl -s https://api.kkaiapi.com/v1/models \
  -H "Authorization: Bearer sk-你的kkaiapi密钥" | head -50

curl -s https://api.kkaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的kkaiapi密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001","messages":[{"role":"user","content":"ping"}]}'

常见问题