> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dify 外掛

> 在 Dify 中通過 Aihubmix 外掛整合 Claude、GPT、Gemini 等模型，涵蓋對話、向量、重排與語音，並支持為 Claude 開啟提示詞緩存。

## 一鍵安裝 Aihubmix 外掛

直接點擊下方連結，在 Dify Marketplace 頁面點擊「Install」按鈕即可完成安裝：

👉 [前往 Dify 外掛市場](https://marketplace.dify.ai/plugins/langgenius/aihubmix?language=en-US\&theme=system)

**示例圖如下：**

<img src="https://mintcdn.com/aihubmix/UgvkHPDoK6o04763/public/cn/DifyInstallPlugin.png?fit=max&auto=format&n=UgvkHPDoK6o04763&q=85&s=5ad2118c70e24a3ccfba126d74658822" alt="在 Dify 外掛市場安裝 Aihubmix 外掛" width="2110" height="1572" data-path="public/cn/DifyInstallPlugin.png" />

## 配置

1. 首先點擊頁面右上角頭像 → 選擇「Settings」選單
2. 點擊左側「Model Provider」Tab
3. 在右側找到 Aihubmix → 展開 Setup，填入你的[API Key](https://aihubmix.com/token)

<img src="https://mintcdn.com/aihubmix/UgvkHPDoK6o04763/public/cn/DifySettings1.png?fit=max&auto=format&n=UgvkHPDoK6o04763&q=85&s=de2f85f8683d3cfbb3399c134ca51889" alt="在模型供應商中配置 Aihubmix 與 API Key" width="1316" height="709" data-path="public/cn/DifySettings1.png" />

**目前預設的模型有以下 5 大類：**

* LLM：大語言模型
* TEXT EMBEDDING：向量嵌入模型
* RERANK：重排序模型
* SPEECH2TEXT：語音轉文字模型
* TTS：文字轉語音模型

<img src="https://mintcdn.com/aihubmix/UgvkHPDoK6o04763/public/cn/DifyModelsSetting.png?fit=max&auto=format&n=UgvkHPDoK6o04763&q=85&s=a54745dd5dc5729fcf055eaa77705632" alt="模型設定好" width="3110" height="2086" data-path="public/cn/DifyModelsSetting.png" />

**如何新增更多自定義模型？**

點擊「+ Add model」，在彈出面板的 Model Name 選項裡：

* 填入模型廣場中的任何[模型 ID](https://aihubmix.com/models)，比如 `gpt-4o-2024-11-20`。
* 填入你的 API Key 後，點擊「Save」即可。

需要注意的是，由於 Dify 外掛的設計特殊性，目前暫不支援繪圖模型，因此像是 `gpt-image-1` 這種繪圖模型無法加入。

<img src="https://mintcdn.com/aihubmix/UgvkHPDoK6o04763/public/cn/DifyAddModel.png?fit=max&auto=format&n=UgvkHPDoK6o04763&q=85&s=27cdab9167cb531ac3b380dbd7f79ba4" alt="新增自定義模型" width="2600" height="2002" data-path="public/cn/DifyAddModel.png" />

## LLM 選擇

在工作流 (Workflow) 節點中，選擇「LLM」，即可選擇外掛中已經配置好的，由 Aihubmix 提供的模型。

**示例圖如下：**

<img src="https://mintcdn.com/aihubmix/UgvkHPDoK6o04763/public/cn/LLMs.png?fit=max&auto=format&n=UgvkHPDoK6o04763&q=85&s=5c1d113ffb637308b358c79fccebf5c0" alt="LLM配置" width="3110" height="2086" data-path="public/cn/LLMs.png" />

## Embeddings/Reranker 模型選擇

Embeddings/Reranker 模型主要用於知識庫問答，你可以在頂部的 Knowledge Tab 快速體驗，也可以在工作流節點中選擇相應的模型。

**示例圖如下：**

<img src="https://mintcdn.com/aihubmix/UgvkHPDoK6o04763/public/cn/DifyRAG.png?fit=max&auto=format&n=UgvkHPDoK6o04763&q=85&s=2bf6d8cb027a740a2c74f067dc687c7e" alt="RAG配置" width="3096" height="2302" data-path="public/cn/DifyRAG.png" />

## TTS/SST 選擇

TTS/SST 模型主要用於語音解析與合成，選擇工具時，對應的不是常規的「LLM」，而是「Tools」Tab 裡面的「Audio」 類型。
對應關係：

1. TTS 文轉音：選擇「Text to Speech」
2. SST 音轉文：選擇「Speech to Text」

**示例圖如下：**

<img src="https://mintcdn.com/aihubmix/UgvkHPDoK6o04763/public/cn/TTS-SST.png?fit=max&auto=format&n=UgvkHPDoK6o04763&q=85&s=a26b7b2f029daae7dcadecfa2c41a2e5" alt="Audio配置" width="3110" height="2086" data-path="public/cn/TTS-SST.png" />

## Claude 提示詞緩存

在 Dify 中通過本外掛為 Claude 模型開啟提示詞緩存：用 `<cache>…</cache>` 包裹要緩存的提示詞，並把模型參數裡的「大消息自動緩存閾值」設為正整數。完整用法與命中要點見 [Claude 提示詞緩存](./Claude-Cache)。

***

最後更新：2026-06-01
