ReedenAI 助手
配置 AI 服务商
了解 API Key、接口地址、模型、验证和本地工具这些配置项该怎么填。
配置入口
进入：
设置 -> AI 助手
通常按这个顺序配置：
- 添加或选择服务商
- 填写 API Key
- 确认接口地址
- 添加或选择模型
- 保存并验证
- 需要阅读中或阅读外的工具能力时，启用本地工具
常见配置项
| 配置项 | 用途 |
|---|---|
| 提供商 | 当前使用的 AI 平台或自定义兼容服务 |
| API Key | 调用 AI 服务时的密钥 |
| 接口地址 / Base URL | 服务商的 API 地址 |
| 模型 ID | 实际调用的模型名称 |
| 模型名称 | 在 Reeden 中显示的名称 |
| 默认聊天模型 | 普通问答优先使用的模型 |
| 默认图片模型 | AI 生成封面等图片能力使用的模型 |
| 启用本地工具 | 允许 AI 使用阅读页面和书库工具 |
API Key 不要发给别人。别人拿到后可能消耗你的额度或产生费用。
验证配置
保存前建议先测试：
- 点击「验证」或「测试聊天」
- 发送一句短问题
- 确认模型能正常回复
- 再进入阅读页面，或从 AI 助手入口使用阅读外的 AI 功能
如果测试失败，先检查 API Key、接口地址、模型名和账号余额。
自定义兼容服务
很多服务商提供 OpenAI 兼容接口。配置时重点确认：
- 接口地址是否包含正确路径
- 模型 ID 是否需要手动填写
- API Key 是否属于当前服务商
- 当前模型是否支持聊天接口
- 服务商是否要求额外请求头或特殊路径
如果服务商不能自动获取模型列表，可以手动添加模型。
本地工具
启用本地工具后，AI 可以按阅读中或阅读外的用法读取必要的本地上下文。
阅读中可用工具包括当前页、章节、阅读位置、笔记、书评、正文搜索等。
阅读外可用工具包括书籍列表、分类、标签、笔记搜索、书评搜索、书库整理计划等。
如果你只想普通聊天，可以不启用本地工具。
常见错误
- API Key 复制错，或多了空格
- 接口地址填成网页地址，不是 API 地址
- 模型 ID 写错或当前账号无权使用
- 服务商余额不足或额度用完
- 当前网络无法访问服务商
- 自定义兼容接口路径不匹配
- 没有添加模型就直接测试聊天