> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Obsidian Copilot 接入 APIONE

> 在笔记工作区中配置 APIONE 聊天模型。

## 安装 Copilot

在 Obsidian 的第三方插件设置中查找并安装 Copilot，按工作区规则启用插件。打开 Copilot 设置，找到模型管理区域。

## 添加聊天模型

选择添加模型，按下表填写：

| 字段 | 设置 |
| - | - |
| 显示名称 | APIONE |
| Provider | OpenAI / OpenAI Compatible |
| Base URL | [https://api.apione.ai/v1](https://api.apione.ai/v1) |
| API Key | 自己的 APIONE API Key |
| Model | APIONE 实际模型 ID |

模型 ID 可从 [模型目录](https://apione.ai/zh/models) 或当前密钥的 /v1/models 返回结果获取。若插件要求上下文长度，按该模型参数填写。

## 测试与设为默认

保存后执行模型连接测试，再打开 Copilot 聊天面板选中新增模型。先发送一句简单问题；成功后，选择一篇不含敏感内容的测试笔记，让模型总结其要点。

## 配置笔记检索

聊天模型与 Embedding 模型是两类配置。如果要为笔记库建立向量索引，需要另行设置受支持的 Embedding 模型及端点。聊天连接成功不代表索引功能也已配置完成。调整嵌入模型后，按插件提示重建索引。

## 排查问题

模型测试成功但聊天失败时，检查聊天面板是否仍选中了旧模型。大笔记失败时检查上下文长度和附件大小。出现 401 或 404，分别检查密钥权限和 Base URL 的 /v1 是否重复。

***

[返回集成目录](https://apione.ai/docs/guides/clients.md) · [模型选择](https://apione.ai/docs/models/catalog.md) · [错误排查](https://apione.ai/docs/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.