为什么需要配置 API 密钥?
Obsidian Copilot 本身不提供 AI 模型服务,它需要连接外部的 AI 服务提供商。配置 API 密钥后,你可以:
- 在笔记中直接与 AI 对话
- 智能分析和总结笔记内容
- 自动生成文章大纲和草稿
- 基于你的知识库进行问答
快速开始:配置 API 密钥
步骤 1:打开 API 密钥设置
在 Obsidian Copilot 的设置界面中,点击"API Keys"区域的"Set Keys"按钮,即可进入 API 密钥配置对话框。
步骤 2:配置 OpenRouter API 密钥
OpenRouter 是一个聚合平台,可以访问多种 AI 模型。配置方法:
- 访问 OpenRouter 官网 注册账号
- 在 API 密钥管理页面获取你的密钥
- 在 Copilot 的 API 密钥对话框中粘贴密钥
步骤 3:配置 Google Gemini API 密钥
Gemini 是 Google 的最新 AI 模型,配置步骤:
- 前往 Google AI Studio
- 创建 API 密钥并复制
- 在相应字段中输入密钥
步骤 4:配置 OpenAI API 密钥
如果你有 OpenAI 账号,也可以直接配置:
- 登录 OpenAI 平台
- 进入 API 密钥管理页面
- 生成新的密钥并保存
主流 AI 提供商配置详解
OpenRouter 配置
- 优势:支持多种模型,成本较低
- 适用场景:日常对话、文本分析
- 推荐模型:Gemini 2.5 Flash、Claude 3 Sonnet
Google Gemini 配置
- 优势:与 Google 生态深度整合,免费额度
- 适用场景:与 Google 文档联动、多模态处理
OpenAI 配置
- 优势:模型成熟稳定,功能全面
- 适用场景:复杂推理、代码生成
高级配置技巧
自定义模型添加
在模型设置界面,你可以添加自定义模型。
模型验证与测试
配置完成后,建议进行模型验证:
- 检查 API 密钥是否正确
- 测试模型响应速度
- 验证功能是否正常
实用配置建议
- 多提供商备份:建议配置 2-3 个不同提供商的 API 密钥,确保服务稳定性
- 成本控制:设置使用限额,监控 API 使用量

