MoleAPIMoleAPI
文档AI 应用

Dify - 开源LLM知识库

Dify 是开源的 LLM 应用开发平台;本文介绍 Dify 并说明如何通过 OpenAI-API-compatible 方式接入 MoleAPI。

Dify 是开源的 LLM 应用开发平台,支持通过可视化编排构建聊天应用、Agent、Workflow 与知识库应用。你可以使用 Dify 云服务或自建部署,并在工作区中接入多种模型供应商。下文说明如何在 Dify 中接入 MoleAPI。

适用说明

本文适用于在 Dify 工作区中通过 OpenAI-API-compatible 模型供应商接入 MoleAPI,用于聊天应用、 Agent、Workflow 与知识库应用。

权限要求

根据 Dify 官方文档,只有 Workspace Owner / Admin 才能在 Settings -> Model Providers 中新增或修改模型供应商。普通成员只能使用已配置好的模型。

准备工作

  • 已拥有可登录的 Dify 工作区
  • 当前账号具备工作区 OwnerAdmin 权限
  • 已在 MoleAPI 控制台 创建可用的 API Key

在 Dify 中接入 MoleAPI

第一步:打开 Model Providers

进入 Dify 工作区后,打开 Settings,进入 Model Providers

如果你的工作区已经配置过 OpenAI、Anthropic、Google 等供应商,请确认这次要新增的是 OpenAI-API-compatible,而不是 Dify 托管的系统模型。

第二步:选择 OpenAI-API-compatible

Model Providers 列表中找到并打开 OpenAI-API-compatible

这是 Dify 官方用于接入 OpenAI 兼容代理、网关或中转服务的入口,MoleAPI 也通过这一方式接入。

在 Dify 中打开 Model Providers 并选择 OpenAI-API-compatible

第三步:填写 MoleAPI 的 API Key 和 Base URL

在新增模型或新增凭据时,填写以下信息:

  • API Key:你的 MoleAPI Key
  • Base URLhttps://api.moleapi.com/v1

Base URL 写法

Dify 这里建议直接填写完整的 OpenAI 兼容地址:https://api.moleapi.com/v1

保存前可先使用 Dify 的验证能力检查凭据是否可用;若界面没有单独的验证按钮,则直接保存后继续添加模型。

第四步:添加 MoleAPI 中可用的模型

OpenAI-API-compatible 下点击 Add Model,填写你要接入的 MoleAPI 模型。

常见字段可按下面方式填写:

  • Model Name:填写 MoleAPI 的模型 ID,例如 gpt-5claude-opus-4-6gemini-2.5-pro
  • Model Type:聊天模型选 Chat
  • Base URLhttps://api.moleapi.com/v1
  • API Key:你的 MoleAPI Key

如果你还要接入 Embedding 模型,则将 Model Type 改为 Text Embedding,并填写对应模型 ID。

在 Dify 中添加 MoleAPI 模型

模型参数填写建议

Dify 在添加自定义模型时,可能还会要求填写上下文长度、最大输出 Token、是否支持视觉等信息。 这些值应以你实际接入的 MoleAPI 模型能力为准;如果当前只是先验证链路,可先使用 Dify 默认值或按模型文档填写。

第五步:在应用中选择模型

模型保存完成后,回到 Dify 的应用编排页面,在聊天模型、Agent 模型或 Workflow 节点中选择刚刚添加的模型即可。

如果你的工作区中已经有多个模型供应商,建议给 MoleAPI 接入的模型命名清晰一些,便于团队区分。

常见问题

看不到 Model Providers 配置入口

  • 检查当前账号是否为工作区 OwnerAdmin
  • 普通成员通常只能使用现有模型,不能新增供应商

保存模型后无法调用

  • 检查 Base URL 是否填写为 https://api.moleapi.com/v1
  • 检查 API Key 是否复制完整、是否仍然有效
  • 检查填写的是否是 MoleAPI 模型 ID,而不是展示名称

模型能保存,但应用里找不到

  • 确认模型类型填写正确:聊天模型用 Chat,向量模型用 Text Embedding
  • 返回应用编辑页后刷新一次模型下拉框
  • 检查该模型是否已经被设置为当前节点可用模型

参考

这篇文档对您有帮助吗?

最后更新于

返回首页网关