FastGPT 接入

FastGPT 是开源的知识库问答平台，通过 OpenAI 兼容渠道接入 Router 的模型。

• 协议：OpenAI Chat Completions
• 接入地址：https://routerapi.<你的域名>/v1

准备工作

1. 登录 Router 控制台，签发一个 Key 并保存明文
2. 在控制台「快速接入」页记下 OpenAI Chat Completions 协议的接入地址
3. FastGPT 管理员权限（配置模型渠道需要）

配置

FastGPT 的模型接入走 OneAPI / new-api 渠道（FastGPT 标准部署自带 OneAPI 容器）：

1. 登录 FastGPT 配套的 OneAPI（或 new-api）管理台 → 渠道 → 添加渠道
2. 填写：
   • 类型：选 OpenAI（或自定义 OpenAI 兼容）
   • 名称：VeyraOS Router（随意）
   • Base URL / 代理地址：https://routerapi.<你的域名>/v1
   • 密钥：你的 Key
   • 模型：填控制台「可用模型」列表中的模型名（可多个）
3. 保存渠道并点测试，状态变绿即通道可用
4. 回到 FastGPT → 账号设置 → 模型配置，启用刚接入的模型（如列表没有，检查渠道的模型是否已同步）

验证

在 FastGPT 创建一个简易知识库或直接发起对话，模型选刚启用的模型。正常回复即接入成功；控制台「调用记录」出现调用明细。

常见问题

Q：渠道测试失败？ 检查 Base URL 以 /v1 结尾、密钥完整、OneAPI 容器网络可访问数据面域名。

Q：FastGPT 里看不到模型？ OneAPI 渠道的模型列表修改后，FastGPT 侧需要确认模型已启用（模型配置页）；两处模型名必须一致。

Q：对话正常但知识库召回差？ 知识库效果主要受 embedding 模型影响；本页接入的是对话模型，embedding 需在渠道中另行配置（如服务提供方提供）。