算力猫
← 返回教程列表

接入软件

RAGFlow

在 RAGFlow 的 Model providers 里添加一个 OpenAI-API-compatible 供应商。

约 6 分钟适合:自己部署 RAGFlow 做文档问答的管理员

开始之前

  • RAGFlow 已部署并能登录
  • 一把 Key 和一个模型名

步骤 1 · STEP 0x01

选择供应商

User settings → Model providers
1

Available models

OpenAI-API-compatible
2

实例名称

随便取
示意图,以软件当前版本界面为准

进入 User settings → Model providers,在 Available models 里选 OpenAI-API-compatible 这一类供应商,给这个实例取个名字。中文界面对应「用户设置 → 模型提供商」,以你的版本为准。

去创建 Key →

步骤 2 · STEP 0x02

填 Key、Base URL 并添加模型

OpenAI-API-compatible
1

API Key

<你的 Key>
2

Base URL

https://api.suanlimao.shop/v1
3

模型名(自定义模型)

<模型名>
4

模型类型

chat
5

Max context length(可选)

按模型参数
6

Tool calling(可选)

模型支持时开
7
验证并保存
示意图,以软件当前版本界面为准
  • Base URL 填 https://api.suanlimao.shop/v1。官方提示「使用兼容 API 时确认路径是否需要包含 /v1」——我们的接口需要。
  • 添加自定义模型时,官方要求模型名必须与供应商 API 暴露的模型 ID 一致,即模型广场里的名字。
  • 保存前会验证;失败时会有警告标记,点开看具体报错。
模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。

打开模型广场 →

步骤 3 · STEP 0x03

设为默认模型并测试

Model providers → System model settings
1

Chat model

<模型名>
2

聊天助手 → 测试

用一句话介绍这份文档
示意图,以软件当前版本界面为准
  • 在系统模型设置里把 Chat model 指到这个模型,然后在聊天助手里试一句。
向量(embedding)、重排序模型也可以用同样方式添加,模型类型分别选 embedding / rerank;模型广场没有的类型就用 RAGFlow 内置模型。

✓ 怎么确认成功了

  • 供应商验证通过;聊天助手能回答;控制台「用量」页出现请求。

常见问题

验证失败?

官方排错顺序:凭据、端点(Base URL 是否带 /v1)、模型名、服务可用性、额度。逐项核对后重新验证。

模型能聊但解析文档很慢?

文档解析走的是 embedding 和 OCR 等模型,与聊天模型无关;检查那些模型的配置。

相关教程

还是不行?

先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。