AI 配置
Jotaid 的 AI 功能运行在你自己的 API Key 上（BYOK——自带 Key）。没有任何内容经过 Jotaid 的服务器中转；你的笔记直接发送给你选择的服务商。本节将带你从头到尾完成配置。
需要 Pro
AI 功能是 Jotaid Pro 的一部分。你可以通过年度订阅或一次性买断解锁 Pro（两者解锁的功能完全相同），之后用你自己的 API Key 来运行。详见 免费版 vs Pro。
为什么是自带 Key
Jotaid 不内嵌 AI 服务——它不代你调用某个由 Jotaid 托管的模型，而是让你把自己的 Key 填进来，请求直接从你的设备发往你选的服务商。
这带来三件实在的事：
| 自带 Key 意味着 | |
|---|---|
| 数据路径 | 笔记只经过两端：你的设备 → 你选的服务商。中间没有 Jotaid 的服务器，也就没有「我们承诺不看」这种需要你相信的环节 |
| 成本 | 按你自己的用量向服务商付费，用多少算多少；Jotaid 不在中间加价，也不设额度 |
| 选择权 | 换模型、换服务商，甚至用 Ollama 跑在本机——都不用等 Jotaid 更新 |
代价也是真实的：你得自己去申请一个 Key，这一步确实比"打开开关就能用"麻烦。
内嵌选项不是不做，是还没到时候
要由 Jotaid 代管推理，意味着我们要同时承担你笔记内容的数据处理责任与一套 AI 运行时的合规审核——这两件事都不是加个后端就算完的。在条件成熟之前，与其端出一个含糊的托管方案，不如让你现在就能用上、并且清楚知道数据去了哪里。我们会伺机推出内嵌选项，届时自带 Key 仍然保留。
支持的服务商
Jotaid 原生支持四家服务商，另外还支持任何兼容 OpenAI 的服务。
原生服务商
| 服务商 | 默认模型 |
|---|---|
| OpenAI | gpt-4o-mini |
| Anthropic Claude | claude-3-5-sonnet |
| Google Gemini | gemini-2.5-flash |
| DeepSeek | deepseek-v4-flash |
兼容 OpenAI 的服务
任何采用 OpenAI API 格式的服务商也都能用。Jotaid 内置了 Groq、OpenRouter、Together AI、Mistral、xAI (Grok)、Moonshot (Kimi)、Zhipu (GLM)、Qwen、SiliconFlow、Fireworks、Perplexity 以及 Ollama（本地）的预设。你也可以粘贴任意 base URL 来添加一个自定义端点。
还没有 Key？
各家服务商的申请入口、Key 的样子与费用控制，见申请 API Key。
四步完成配置
- 打开 设置 → AI
- 从列表中选择一个服务商
- 把你的 API Key 粘贴到 Key 输入框
- 选择一个模型——大多数服务商会提供一份精选列表；Gemini 会实时拉取其模型列表
就这样。一旦保存了有效的 Key，每一项 AI 功能都会随之可用。
功能开关
配置完成后，在 设置 → AI 中控制哪些 AI 助手处于激活状态：
- 自动标题与标签——自动命名新笔记并推荐标签（默认开启）
- Theme 总结——把一个 Theme 中的所有笔记综合成关键洞察
- Node 内容充实——用 AI 生成的内容扩展一个概念 Node
- 智能格式——整理当前笔记的 Markdown 格式（⇧⌘F）
- 语义建议——浮现你可能遗漏的笔记之间的链接
关于每一项在哪触发、具体做什么，请见 AI 功能。
隐私
- 你的 API Key 保存在系统 Keychain 本地——绝不同步，绝不发送给 Jotaid
- 笔记内容只会发送给你配置的服务商，且仅在你触发某项功能时
- 不收集任何数据，也不用于训练
常见问题排查
- 「无效的 API Key」——仔细检查你复制的是完整的 Key、末尾没有多余空格，并确认该 Key 在服务商那边有余额/额度。
- 结果为空或被截断——试试更大的模型，或换一个输出上限更高的服务商。非常小的模型可能会把结构化输出截断。
- 模型未列出——选择自定义或某个兼容 OpenAI 的预设，然后手动输入模型名称。