ReedenReeden
AI 助手

配置 AI 服务商

了解 API Key、接口地址、模型、测试聊天和本地工具这些配置项该怎么填。

配置入口

进入：

设置 -> AI 助手

Reeden 不提供 AI 服务，需要你自己到服务商那里申请 API Key。通常按这个顺序配置：

  1. 添加或选择服务商。列表里没有的服务商，点右上角「+」打开「添加提供商」，在「预置提供商」里选，或手动填名称
  2. 填写 API Key
  3. 确认接口地址，写法见下面的 接口地址怎么填
  4. 点「模型」旁的刷新按钮获取模型列表，获取不到就手动添加模型
  5. 在要用的模型右侧更多菜单里选「设为默认聊天模型」，要生成封面再选一个「设为默认图片模型」
  6. 点击右上角更多菜单里的「测试聊天」
  7. 需要阅读中或阅读外的工具能力时，启用本地工具

截图求助时，记得把 API Key 打码。

常见配置项

配置项用途
提供商当前使用的 AI 平台或自定义兼容服务
API Key调用 AI 服务时的密钥
接口地址 / Base URL服务商的 API 地址
图片生成地址生图接口地址，用于 AI 生成封面
模型 ID实际调用的模型名称
模型名称在 Reeden 中显示的名称
默认聊天模型普通问答优先使用的模型
默认图片模型AI 生成封面等图片能力使用的模型
启用本地工具允许 AI 使用阅读页面和书库工具

API Key 不要发给别人。别人拿到后可能消耗你的额度或产生费用。

AI 服务商配置页面

接口地址怎么填

接口地址在界面上叫「API 地址」。用预置提供商时，它会自动填好，一般不用改。改乱了可以点输入框右侧的恢复按钮，还原成预置地址。

自己添加的服务商，接口地址要填 OpenAI 兼容的聊天接口，写完整，一直写到 /chat/completions：

服务商接口地址
DeepSeekhttps://api.deepseek.com/v1/chat/completions
其他 OpenAI 兼容服务、中转站https://服务商域名/v1/chat/completions

常见填错的情况：

  • 只填了域名或 /v1，没写 /chat/completions，容易报 301、404，或返回一段网页而不是回复
  • 填成了服务商官网或控制台的网页地址
  • 服务商文档里的路径不是 /v1（比如 /v4、/api/v3），按文档照抄，只把结尾写到 /chat/completions

获取不到模型怎么办

点「模型」旁的刷新按钮，Reeden 会向服务商请求模型列表，成功时提示「模型列表已更新」。

提示「获取模型列表失败」时：

  1. 先检查接口地址和 API Key
  2. 有的服务商不提供模型列表接口，这时点「模型」旁的更多菜单，选「添加模型」手动填
  3. 「模型 ID」要和服务商文档或控制台里的名称一字不差，「模型名称」只是 Reeden 里显示的名字，可以随便起

加完模型后，别忘了把它「设为默认聊天模型」。设好的模型名旁会显示「聊天」标记，默认图片模型显示「图片」标记。

测试聊天

配置完成后，建议先用「测试聊天」（也有人叫「测试对话」）确认聊天接口能正常调用。

  1. 打开「设置 -> AI 助手」
  2. 点击右上角更多菜单
  3. 选择「测试聊天」
  4. 确认弹窗里能正常返回回复

测试聊天用的是默认聊天模型（带「聊天」标记的那个）和它所属的服务商，发送一句内置的测试问题。还没设默认聊天模型时，会提示「请先添加模型」。

想测试别的模型，先把它设为默认聊天模型再点「测试聊天」。

如果测试失败，先检查 API Key、接口地址、模型名、账号余额和当前网络。测试也会消耗额度，余额不足同样会失败。

图片生成配置

AI 生成封面需要单独配置图片生成能力。聊天模型可用，不代表图片生成可用。

需要确认三件事：

  1. 当前服务商填写了 API Key。
  2. 当前服务商有可用的「图片生成地址」，可以手动填写，也可以由兼容聊天地址推导。
  3. 某个支持生图的模型已经被设为「默认图片模型」。

设置默认图片模型的方法：

  1. 在模型列表中找到支持图片生成的模型。
  2. 打开该模型右侧的更多菜单。
  3. 选择「设为默认图片模型」。
  4. 确认模型名称旁边出现「图片」标记。

设置完成后，可以从右上角更多菜单选择「测试图片生成」。确认测试图能生成后，再去书籍或分类封面里使用「AI 生成封面」。

图片模型可以和聊天模型来自不同服务商。Reeden 会记录图片模型所属的服务商，生成封面时使用该服务商的 API Key 和图片生成地址。

详细步骤见 AI 生成封面。

自定义兼容服务

很多服务商提供 OpenAI 兼容接口。配置时重点确认：

  • 接口地址是否包含正确路径
  • 模型 ID 是否需要手动填写
  • API Key 是否属于当前服务商
  • 当前模型是否支持聊天接口
  • 图片生成模型是否需要单独的接口地址
  • 服务商是否要求额外请求头或特殊路径

如果服务商不能自动获取模型列表，可以手动添加模型，见 获取不到模型怎么办。

本地工具

启用本地工具后，AI 可以按阅读中或阅读外的用法读取必要的本地上下文。

阅读中可用工具包括当前页、章节、阅读位置、笔记、书评、正文搜索等。

阅读外可用工具包括书籍列表、分类、标签、笔记搜索、书评搜索、书库整理计划等。

如果你只想普通聊天，可以不启用本地工具。

常见错误

  • API Key 复制错，或多了空格
  • 接口地址填成网页地址，不是 API 地址
  • 模型 ID 写错或当前账号无权使用
  • 服务商余额不足或额度用完
  • 当前网络无法访问服务商
  • 自定义兼容接口路径不匹配
  • 没有添加模型就直接测试聊天
  • 只设置了聊天模型，没有设置默认图片模型

选择 AI 服务

根据网络、模型能力、费用和使用场景，选择适合自己的 AI 服务商和模型。

AI 生成封面

配置图片生成地址和默认图片模型，用 AI 为书籍或分类生成封面。