AI 配置
Jotaid 的 AI 功能运行在你自己的 API Key 上（BYOK——自带 Key）。没有任何内容经过 Jotaid 的服务器中转；你的笔记直接发送给你选择的服务商。本节将带你从头到尾完成配置。
需要 Pro
AI 功能是 Jotaid Pro 的一部分。你通过一次性购买解锁它们，之后用你自己的 API Key 来运行。详见 免费版 vs Pro。
支持的服务商
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 来添加一个自定义端点。
四步完成配置
- 打开 设置 → AI
- 从列表中选择一个服务商
- 把你的 API Key 粘贴到 Key 输入框
- 选择一个模型——大多数服务商会提供一份精选列表；Gemini 会实时拉取其模型列表
就这样。一旦保存了有效的 Key，每一项 AI 功能都会随之可用。
获取 API Key
每家服务商都在其自己的开发者控制台里签发 Key（例如 OpenAI 的 API Keys 页面或 Anthropic 的 Console）。在那里创建一个 Key，复制它，然后粘贴进 Jotaid。
功能开关
配置完成后，在 设置 → AI 中控制哪些 AI 助手处于激活状态：
- 自动标题与标签——自动命名新笔记并推荐标签（默认开启）
- Theme 总结——把一个 Theme 中的所有笔记综合成关键洞察
- Node 内容充实——用 AI 生成的内容扩展一个概念 Node
- Tidy Up（格式化）——整理当前笔记的 Markdown 格式（⇧⌘F）
- 语义建议——浮现你可能遗漏的笔记之间的链接
关于每一项从头到尾具体做什么，请见 AI 工作流。
隐私
- 你的 API Key 保存在系统 Keychain 本地——绝不同步，绝不发送给 Jotaid
- 笔记内容只会发送给你配置的服务商，且仅在你触发某项功能时
- 不收集任何数据，也不用于训练
常见问题排查
- 「无效的 API Key」——仔细检查你复制的是完整的 Key、末尾没有多余空格，并确认该 Key 在服务商那边有余额/额度。
- 结果为空或被截断——试试更大的模型，或换一个输出上限更高的服务商。非常小的模型可能会把结构化输出截断。
- 模型未列出——选择自定义或某个兼容 OpenAI 的预设，然后手动输入模型名称。