前置条件 #
- 已安装 Obsidian — obsidian.md
- 已安装并启用 Obsidian Copilot 插件
- 已有 WoAiToken 账号并完成充值 — to.woaitoken.com
- 您的 sub2api API Key（Step 1 中获取）
> 本教程基于 Obsidian Copilot 插件。若使用其他插件（Smart Connections、Text Generator 等），设置位置不同，但 API Base URL 和 Key 填写方式一致。
Step 1 — 获取 API Key #
1. 打开控制台
访问 to.woaitoken.com/console 并登录。
2. 新建令牌
进入 令牌 → 新增令牌，填写名称（如"Obsidian"），有效期选无限制，点击 提交。
3. 复制密钥
复制生成的密钥——以 sk- 开头。请立即保存，密钥仅展示一次。
Step 2 — 安装 Obsidian Copilot #
1. 打开 Obsidian → 设置 → 第三方插件 2. 点击 浏览，搜索 Copilot 3. 安装并启用插件
Step 3 — 配置 Obsidian Copilot #
1. 进入 设置 → Copilot 2. 在 聊天模型 下，将 模型提供商 设置为 openai 3. 填入 OpenAI API Key：sk-your-key-here 4. 向下滚动至 高级设置 5. 启用 使用代理 / 自定义端点 6. 将 OpenAI API Base 设置为：https://to.woaitoken.com/v1 7. 选择 模型（如 claude-sonnet-4-5 或 gpt-4o） 8. 点击 保存
> 📸 此处添加 Copilot 设置界面截图。
Step 4 — 验证连接 #
1. 打开 Copilot 面板（Ctrl/Cmd + Shift + P → 搜索"Copilot"） 2. 发送一条测试消息（如"你好"） 3. 收到回复即代表连接成功
常见问题 #
"Invalid API key" 错误 确保密钥以 sk- 开头且无多余空格。
无响应 / 超时 确认 API Base 为 https://to.woaitoken.com/v1（含 /v1）。
模型不可用 在 to.woaitoken.com/console 中查看可用模型，仅使用列表中的模型。
429 Too Many Requests 账号额度已用尽，请前往 woaitoken.com 充值。
