---
title: 接入 Hugging Face 上的开源模型
---


Dify 支持 Text-Generation 和 Embeddings，以下是与之对应的 Hugging Face 模型类型：

* Text-Generation：[text-generation](https://huggingface.co/models?pipeline\_tag=text-generation\&sort=trending)，[text2text-generation](https://huggingface.co/models?pipeline\_tag=text2text-generation\&sort=trending)
* Embeddings：[feature-extraction](https://huggingface.co/models?pipeline\_tag=feature-extraction\&sort=trending)

具体步骤如下：

1. 你需要有 Hugging Face 账号([注册地址](https://huggingface.co/join))。
2. 设置 Hugging Face 的 API key([获取地址](https://huggingface.co/settings/tokens))。
3. 进入 [Hugging Face 模型列表页](https://huggingface.co/models)，选择对应的模型类型。

![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/development/models-integration/af8a771b1e71152837e0f25b87a4471e.png)

Dify 支持用两种方式接入 Hugging Face 上的模型：

1. Hosted Inference API。这种方式是用的 Hugging Face 官方部署的模型。不需要付费。但缺点是，只有少量模型支持这种方式。
2. Inference Endpoint。这种方式是用 Hugging Face 接入的 AWS 等资源来部署模型，需要付费。

### 接入 Hosted Inference API 的模型

#### 1 选择模型

模型详情页右侧有包含 Hosted inference API 的 区域才支持 Hosted inference API 。如下图所：

![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/development/models-integration/dc5a5584cef16fe76595058d37043546.png)

在模型详情页，可以获得模型的名称。

![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/development/models-integration/248a80fb0dac520e690cb122dbe91324.png)

#### 2 在 Dify 中使用接入模型

在 `设置 > 模型供应商 > Hugging Face > 模型类型` 的 Endpoint Type 选择 Hosted Inference API。如下图所示：

![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/development/models-integration/0bb37fe604f12bf766a84538574e36a6.png)

API Token 为文章开头设置的 API Key。模型名字为上一步获得的模型名字。

### 方式 2: Inference Endpoint

#### 1 选择要部署模型

模型详情页右侧的 `Deploy` 按钮下有 Inference Endpoints 选项的模型才支持 Inference Endpoint。如下图所示：

![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/development/models-integration/0821340197577ff126440b2558446890.png)

#### 2 部署模型

点击模型的部署按钮，选择 Inference Endpoint 选项。如果之前没绑过银行卡的，会需要绑卡。按流程走即可。绑过卡后，会出现下面的界面：按需求修改配置，点击左下角的 Create Endpoint 来创建 Inference Endpoint。

![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/development/models-integration/f7582adc0937dc4f038e462b578d9c17.png)

模型部署好后，就可以看到 Endpoint URL。

![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/development/models-integration/30c38995813c0d05c35c42dc0f1d467c.png)

#### 3 在 Dify 中使用接入模型

在 `设置 > 模型供应商 > Hugging Face > 模型类型` 的 Endpoint Type 选择 Inference Endpoints。如下图所示：

![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/development/models-integration/ca2b2f7d98954ba92753d04440543caa.png)

API Token 为文章开头设置的 API Key。`Text-Generation 模型名字随便起，Embeddings 模型名字需要跟 Hugging Face 的保持一致。`Endpoint URL 为 上一步部署模型成功后获得的 Endpoint URL。

![](https://assets-docs.dify.ai/dify-enterprise-mintlify/zh_CN/development/models-integration/6a8908cace5b287070577bf555d69b0c.png)

> 注意：Embeddings 的「用户名 / 组织名称」，需要根据你在 Hugging Face 的 [Inference Endpoints](https://huggingface.co/docs/inference-endpoints/guides/access) 部署方式，来填写「[用户名](https://huggingface.co/settings/account)」或者「[组织名称](https://ui.endpoints.huggingface.co/)」。

{/*
Contributing Section
DO NOT edit this section!
It will be automatically generated by the script.
*/}

---

[编辑此页面](https://github.com/langgenius/dify-docs/edit/main/zh-hans/development/models-integration/hugging-face.mdx) | [提交问题](https://github.com/langgenius/dify-docs/issues/new?template=docs.yml)

