配置第一个 AI 模型

本教程以 AIHubMix 为例，带你配置第一个对话模型，并在 NoteGen 中验证回复。NoteGen 也支持其他 OpenAI 兼容服务，以及 Ollama、LM Studio 等本地服务。

准备工作

• 安装并打开 NoteGen。以下步骤对应桌面端 0.38.2。
• 登录 AIHubMix，进入控制台创建并复制 API Key。
• 打开 AIHubMix 的模型列表，复制要使用的模型 ID。本教程使用 gpt-5.6-terra 作为对话示例，实际可用模型以供应商列表和账户权限为准。

AIHubMix 是模型平台，gpt-5.6-terra 是该平台下的具体模型。先配置平台的连接信息，再添加模型，最后为相应功能选择模型。

配置模型平台

以下每一步均使用对应的 NoteGen 局部复刻组件。组件中的编号对应下方的操作说明，标出需要填写或点击的位置。平台列表从 NoteGen 的 CDN 配置中心获取；密钥、模型配置与连接检测均为本地模拟，可以切换平台、添加模型和调整参数，刷新页面后重置。请勿在演示中填写真实密钥。

1. 选择模型平台

模型平台

1AI

AIHubMix

正在获取平台模板…

添加自定义平台

1. 1点击已标出的平台行选择平台；点击平台名称可访问分享链接。

点击窗口右上角的设置按钮，在左侧 AI 分组中打开 模型服务，然后在 模型平台 列表中选择带有“赞助商”标识的 AIHubMix。

如果没有看到 AIHubMix，检查网络后关闭设置并重新打开。也可以点击 添加自定义平台，将名称填写为 AIHubMix，再按下一步填写连接信息。

2. 填写连接设置

连接设置

管理服务地址、API Key、网络代理和自定义请求头。修改会自动保存。

1API 地址

配置到服务商要求的版本路径即可，例如：https://api.example.com/v1。

2API Key

3网络代理

为当前模型平台选择代理方式。继承模式使用高级设置中的全局代理。

1. 1API 地址填到 /v1。
2. 2填入平台创建的 API Key。
3. 3选择网络代理方式。

切换到 连接设置，填写以下内容：

修改会自动保存。API 地址填写到 /v1，不要附加 /chat/completions 或 /embeddings，NoteGen 会按模型类型拼接接口路径。主地址暂时不可用时，可使用供应商提供的备用地址 https://api.inferera.com/v1。

3. 添加对话模型

模型列表

在这里管理当前平台下的所有模型，每个模型可以有不同的类型和参数。

4添加模型

gpt-5.6-terra对话

3检测连接

1模型

gpt-5.6-terra

2模型类型

对话语音合成语音识别嵌入重排序

高级参数

1. 1填写模型 ID。
2. 2选择“对话”类型。
3. 3检测当前模型的连接。
4. 4需要更多模型时点击“添加模型”。

1. 切换到 模型列表，点击 添加模型。
2. 在新展开的模型卡片中点击 请选择模型，搜索并选择 gpt-5.6-terra，或你从供应商列表复制的其他模型 ID。
3. 将 模型类型 设为 对话（chat），新模型默认就是这一类型。
4. 最大输出 Token、上下文窗口、Temperature 等高级参数先保持默认。

列表中没有目标模型时，输入完整模型 ID，点击 Use "模型 ID"。如果显示的是输入框，直接粘贴模型 ID；也可以点击右侧刷新按钮重新获取列表。

平台显示“已就绪”表示必要字段已经填好，接下来还需要检测连接。

4. 检测连接

gpt-5.6-terra对话

1检测连接

2模拟结果：AI 连接测试通过

1. 1点击“检测连接”。
2. 2查看连接测试结果；这里展示模拟成功。

点击模型卡片上的 检测连接。出现 AI 连接测试通过，说明当前配置能够调用该模型。需要更多模型时，在同一平台下重复添加并逐个检测。

在对话和写作中使用

1. 选择对话模型

AIHubMix

2gpt-5.6-terra

1gpt-5.6-terra

1. 1点击底部状态栏的模型名称打开选择器。
2. 2选择已配置的对话模型。

关闭设置，点击窗口底部状态栏右侧的当前模型名称，在 AIHubMix 分组中选择刚添加的对话模型。

2. 验证模型回复

1. 1发送一条简单消息。
2. 2收到回复后确认配置成功。

在右侧对话面板中发送一条简单消息，例如“请用一句话介绍 Markdown”。能收到正常回复，即完成了从配置到实际调用的验证。对话面板未显示时，点击窗口右上角的 显示右侧边栏。

3. 在编辑器中使用

用 Markdown 记录笔记

1Markdown 让我们用纯文本记录笔记，并通过标题和列表组织内容。

保存原始想法，再逐步整理为清晰的笔记。

2

3润色

精简

扩展

从选区生成画布

生成流程图生成思维导图生成时间线提取任务关系

翻译

1. 1在编辑器中选中一段文字。
2. 2点击浮动工具栏中的 AI。
3. 3选择润色、精简或扩展等操作。

编辑器未单独指定模型时，会跟随当前主要模型。在笔记中选中文字，点击浮动工具栏中的 AI，即可使用润色、精简、扩展或翻译。需要单独指定时，前往 设置 → 编辑器设置 → 默认模型 → 编辑器模型。

配置知识库模型（可选）

知识库需要嵌入模型生成向量，重排模型用于优化检索结果排序，可按需添加。

1. 添加嵌入模型

模型列表

在这里管理当前平台下的所有模型，每个模型可以有不同的类型和参数。

4添加模型

text-embedding-3-small嵌入

3检测连接

1模型

text-embedding-3-small

2模型类型

对话语音合成语音识别嵌入重排序

1. 1填写嵌入模型 ID。
2. 2模型类型选择“嵌入”。
3. 3检测嵌入模型连接。
4. 4需要新模型时点击“添加模型”。

在 AIHubMix 的 模型列表 中添加 text-embedding-3-small，将 模型类型 设为 嵌入（embedding），然后检测连接。

2. 添加重排模型

模型列表

在这里管理当前平台下的所有模型，每个模型可以有不同的类型和参数。

4添加模型

qwen3-reranker-0.6b重排序

3检测连接

1模型

qwen3-reranker-0.6b

2模型类型

对话语音合成语音识别嵌入重排序

1. 1填写重排模型 ID。
2. 2模型类型选择“重排序”。
3. 3检测重排模型连接。
4. 4需要新模型时点击“添加模型”。

如需重排，再添加供应商支持的重排模型，例如 qwen3-reranker-0.6b，将类型设为 重排序（rerank），并检测连接。

3. 选择检索模型

检索模型

嵌入模型用于语义检索，重排模型可选；不配置模型时仍可使用本地词法检索。

1嵌入模型

用于将文本转换为向量，实现语义检索。

可用text-embedding-3-small

2重排模型

可选，进一步优化检索结果的相关性顺序。

可用qwen3-reranker-0.6b

1. 1在知识库中选择已添加的嵌入模型。
2. 2需要重排时，选择已添加的重排模型。

打开 设置 → 知识库 → 检索模型，选择刚添加的嵌入模型，以及可选的重排模型。

更换嵌入模型后，建议重新计算知识库向量，避免混用不同模型生成的向量。后续步骤参见建立并使用知识库。

常见问题

检测连接失败

先检查 API Key 是否完整、API 地址是否正确、模型 ID 是否与供应商列表一致，以及模型类型是否匹配。

• 401/403：检查密钥、账户权限和供应商返回的错误信息。
• 404：检查 API 地址是否只填写到 /v1，以及模型 ID 是否正确。
• 超时或网络错误：检查网络与代理；主地址不可用时可尝试上文的备用地址。
• 提示不支持 max_completion_tokens：在高级参数中将 Token 限制参数切换为 max_tokens。

模型选择器中找不到新模型

返回 设置 → 模型服务，确认已填写模型 ID，且类型为 对话。嵌入、重排等模型需要在对应功能设置中选择。

提示未配置主模型

点击底部状态栏的模型名称，在 AIHubMix 分组下选中一个对话模型。添加平台及模型后，还需要完成这一步才能使用 AI 对话。

其他模型服务

其他 OpenAI 兼容服务也可以通过自定义平台接入，将 API 地址、密钥和模型 ID 替换为对应供应商提供的值即可。Ollama 常用 http://localhost:11434/v1，LM Studio 常用 http://localhost:1234/v1，使用前需要启动本地服务。

完整字段说明参见模型配置与模型选择和回退。供应商侧操作可参考 AIHubMix 的 NoteGen 配置教程。