跳到正文
上新Nano Banana 2.1 已上线：Google 新一代生图模型，单张低至 $0.0336，原生 4K，约上一代半价查看模型
HopBase
← 返回博客

企业知识库接入大模型 API:RAGFlow / Dify 配置多模型 | HopBase

HopBase 2026年11月05日 7 分钟阅读

企业知识库接入大模型 API,在 RAGFlow 或 Dify 里新增一个「OpenAI 兼容」供应商即可:Base URL 填 https://api.hop-base.com/v1,填一把 HopBase Key,模型名用 GET /v1/models 返回的 ID。一把 Key 挂多个分组,就能同时用 DeepSeek、GPT、GLM、Kimi、千问;Claude 改用 Anthropic 类型。Embedding 沿用现有供应商。每个知识库应用发一把带额度的 Key,成本按应用拆清楚。

先说清楚:HopBase 不是 RAGFlow / Dify 的内置供应商

目前 RAGFlow 和 Dify 的供应商列表里没有名为 HopBase 的选项。本文用的是两者都提供的通用接入方式:OpenAI 兼容接口。界面名称随版本变化,下文只描述字段,不绑定具体菜单文字。

第一步:准备 Key 并确认模型 ID

  1. 在控制台创建一把 Key,勾选知识库要用的分组(每把 Key 可含 1–10 个分组)。Key 只能调这些分组里的模型。
  2. 给这把 Key 设额度、过期时间,需要时加 IP 名单(填 RAGFlow / Dify 服务器的出口 IP)。
  3. 用这把 Key 查询可用模型,复制返回的完整 ID,不要手打、不要加减后缀:
curl https://api.hop-base.com/v1/models \
  -H "Authorization: Bearer sk-your-key"

模型名写错或不在 Key 的分组里,会返回 404 model_not_found。

第二步:在 RAGFlow 中配置

  1. 进入用户设置里的模型供应商(Model providers)页面。
  2. 选择 OpenAI 兼容类型的供应商,新建一个实例。
  3. Base URL 填 https://api.hop-base.com/v1(带 /v1),API Key 填 sk-your-key。
  4. 添加模型:模型名称填 /v1/models 返回的 ID,模型类型选 chat;支持图片输入的模型才选视觉类型。
  5. 工具调用只在模型支持时打开;逐个验证模型后保存。
  6. 在默认模型设置里把默认对话模型指向刚加的模型。RAGFlow 要求同时设默认 Embedding 模型,这一项保持你现有的供应商。

第三步:在 Dify 中配置

  1. 由工作区所有者或管理员进入模型供应商管理页,安装 OpenAI 兼容类型的供应商插件。
  2. 添加模型:模型名称填完整 ID,API Key 填 sk-your-key,API 地址填 https://api.hop-base.com/v1。
  3. 上下文长度按模型规格填;只有支持图片的模型才打开视觉支持。
  4. 保存后,在知识库应用或工作流的 LLM 节点里选择该模型。

Claude 怎么接

Claude 只走 Anthropic Messages 协议(/v1/messages),在 OpenAI 兼容类型里调用会返回 404。做法:改用 Anthropic 类型供应商,Base URL 填 https://api.hop-base.com(不带 /v1),Key 用包含 Claude 分组的 Key。如果你所用版本的 Anthropic 表单没有可填的 Base URL 字段,那就无法在该版本里通过 HopBase 使用 Claude,可先用 GPT、DeepSeek 等走 OpenAI 兼容接口。

按角色选模型

角色可选模型 ID(以 /v1/models 为准)注意
日常问答deepseek-v4.1-flash、qwen3.8-flash、gpt-6-luna成本低,适合高频检索问答
复杂推理 / 总结gpt-6-sol、qwen3.8-max、Claude(Anthropic 类型)放在需要质量的应用上
长文档(整份合同、手册)kimi-k3、glm-5.3-flash、deepseek-v4.1-flash三者都是约 1M 上下文;kimi-k3 输出上限 32,768 token
图片 / 扫描件理解glm-5.3-flash、deepseek-v4.1-flash两者都接受图片 URL 和 base64
图片(仅 base64)kimi-k3只收 base64 图片,传图片 URL 返回 400

视觉开关只对支持图片的模型打开。例如 deepseek-v4-pro-202606 不收图片,带图请求会在到达模型前返回 400,且不计费。

Embedding 和 Rerank:保持现有供应商

HopBase 当前公开的模型目录不含 Embedding 模型。知识库的向量化和重排继续用你现在的供应商即可。注意:更换 Embedding 模型通常需要重建索引,而只换对话模型不需要——这正是把对话模型接到 HopBase 的好处,改模型不动已有向量。

一个知识库应用一把 Key,成本按应用拆

  1. 一应用一 Key:客服知识库、法务知识库、研发文档各发一把,泄露或滥用只停一把。
  2. Key 额度:每把 Key 设额度,用满后请求在处理前被拒绝(HTTP 402 insufficient_quota),不会烧穿整体预算。
  3. 归部门:未挂成员的 Key 可直接归到部门,按部门设额度,账期日(每月 1–28 号)统一重置。
  4. 导出对账:用量页按 Key 或部门筛选后导出 CSV,逐行可复算「官方成本 × 折扣 ÷ 汇率 = 实扣」,失败请求不计费。

各家模型的参数差异(如 Kimi K3 的 include_reasoning)见一个 OpenAI 兼容 Key 调用国产大模型;Base URL 规则见Base URL 文档,客户端填写方式见第三方客户端。

常见问题

RAGFlow 配置模型报 404 怎么办?

先查三件事:模型名是否与 /v1/models 返回完全一致;Base URL 是否带 /v1;是否把 Claude 放进了 OpenAI 兼容类型(Claude 要用 Anthropic 类型且不带 /v1)。

Dify 能同时接入 Claude、GPT 和 DeepSeek 吗?

可以。一把 Key 挂上对应分组,GPT 和 DeepSeek 走 OpenAI 兼容类型,Claude 走 Anthropic 类型,两个供应商用同一把 Key 即可。

企业知识库的数据会被拿去训练吗?

不会。提示词与输出只用于完成请求,不作为业务数据保留、不用于训练;计费元数据保留用于发票与审计,全程 TLS。

注册 HopBase,给你的知识库发第一把 Key

企业教程