---
description: "从头到尾配置 Jotaid 的自带 Key（BYOK）AI —— 选择服务商、填入 API Key，所有请求都直接从你的 Mac 发往该服务商。"
---
<!--
  Markdown representation of https://docs.jotaid.com/zh/guide/ai-setup
  Generated by scripts/gen-markdown-variants.mjs — do not edit by hand.
  Served from the canonical URL under `Accept: text/markdown`.
-->

# AI 配置

Jotaid 的 AI 功能运行在**你自己的 API Key** 上（BYOK——自带 Key）。没有任何内容经过 Jotaid 的服务器中转；你的笔记直接发送给你选择的服务商。本节将带你从头到尾完成配置。

> **需要 Pro**
>
> AI 功能是 **Jotaid Pro** 的一部分。你可以通过年度订阅或一次性买断解锁 Pro（两者解锁的功能完全相同），之后用你自己的 API Key 来运行。详见 [免费版 vs Pro](https://docs.jotaid.com/zh/guide/pricing)。

## 为什么是自带 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](https://docs.jotaid.com/zh/guide/api-keys)。

## 四步完成配置

1. 打开 **设置 → AI**
2. 从列表中**选择一个服务商**
3. 把你的 **API Key 粘贴**到 Key 输入框
4. **选择一个模型**——大多数服务商会提供一份精选列表；Gemini 会实时拉取其模型列表

就这样。一旦保存了有效的 Key，每一项 AI 功能都会随之可用。

## 功能开关

配置完成后，在 **设置 → AI** 中控制哪些 AI 助手处于激活状态：

- **自动标题与标签**——自动命名新笔记并推荐标签（默认开启）
- **Theme 总结**——把一个 Theme 中的所有笔记综合成关键洞察
- **Node 内容充实**——用 AI 生成的内容扩展一个概念 Node
- **智能格式**——整理当前笔记的 Markdown 格式（⇧⌘F）
- **语义建议**——浮现你可能遗漏的笔记之间的链接

关于每一项在哪触发、具体做什么，请见 [AI 功能](https://docs.jotaid.com/zh/guide/ai-features)。

## 隐私

- 你的 API Key **保存在系统 Keychain 本地**——绝不同步，绝不发送给 Jotaid
- 笔记内容**只会**发送给你配置的服务商，且仅在你触发某项功能时
- 不收集任何数据，也不用于训练

## 常见问题排查

- **「无效的 API Key」**——仔细检查你复制的是完整的 Key、末尾没有多余空格，并确认该 Key 在服务商那边有余额/额度。
- **结果为空或被截断**——试试更大的模型，或换一个输出上限更高的服务商。非常小的模型可能会把结构化输出截断。
- **模型未列出**——选择**自定义**或某个兼容 OpenAI 的预设，然后手动输入模型名称。

## 下一步

- [AI 功能](https://docs.jotaid.com/zh/guide/ai-features) —— 每项功能在哪触发、给你什么
- [语义相关](https://docs.jotaid.com/zh/guide/semantic-relations) —— 语义建议出现的地方