Source: https://wiki.niceai.dev/guide/clients/obsidian-copilot

# Obsidian Copilot 插件接入自定义 API

在 Obsidian 的 **设置 → Copilot → BYOK** 中点击 **Add a provider**，选择添加自定义供应商：Base URL 填 `https://api.niceai.dev/v1`，填入 NiceAI 密钥，再手动添加模型 ID 并保存，就能在 Quick Chat 等功能中选用。

## 准备工作

1. 在 Obsidian 中安装并启用 Copilot 插件。BYOK 不需要购买 Copilot 许可证。
2. 在 NiceAI 控制台「[API 密钥](https://niceai.dev/keys)」页面创建密钥，分组按要用的模型选择。

## 配置步骤

1. 打开 **设置 → Copilot**，切到 **BYOK** 标签页。
2. 点击 **Add a provider**，选择 **Add a custom provider**（自定义 OpenAI 兼容供应商）。
3. 填写：
   - **Display name**：例如 `NiceAI`
   - **API key**：NiceAI 密钥
   - **Base URL**：`https://api.niceai.dev/v1`
4. 在 **Model ID** 中输入 [模型广场](https://niceai.dev/model-plaza) 里的模型名，点击 **Add**，并勾选该模型。
5. 点击 **Save**。新模型会自动出现在 Quick Chat 的模型列表里。

## 常见问题

### 回复不是逐字出现，而是一次性显示？

如果打开了 **Enable CORS**，响应会在生成完成后一次性返回，这是该选项的正常表现。不开启也能正常使用时，建议保持关闭。

### Agent Chat 里的 Claude 或 Codex 没有走 NiceAI？

插件的 Claude、Codex 后端使用各自 CLI 的登录和配置，不读取 BYOK 里的密钥。要让它们走 NiceAI，请分别参考 [Claude Code 接入](https://wiki.niceai.dev/guide/claude-code) 和 [Codex CLI 接入](https://wiki.niceai.dev/guide/codex)。

### 笔记内容会发到哪里？

使用云端 BYOK 供应商时，请求中会包含你的提问和相关笔记片段，并发送到你填写的 Base URL。涉及敏感笔记时请注意这一点。

## 下一步

- [Cherry Studio 接入](https://wiki.niceai.dev/guide/clients/cherry-studio)
- [API 密钥安全最佳实践](https://wiki.niceai.dev/guide/key-security)
