> ## 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 마켓플레이스 페이지에서 **설치** 버튼을 누르기만 하면 됩니다:

👉 [Dify 플러그인 페이지로 이동](https://marketplace.dify.ai/plugins/langgenius/aihubmix?language=en-US\&theme=system)

**예시 이미지:**

<img src="https://mintcdn.com/aihubmix/njYPCqTk0m3HBNaY/public/en/DifyInstallPlugin.png?fit=max&auto=format&n=njYPCqTk0m3HBNaY&q=85&s=1a228911f8d5686b66cafd55cad5a5fd" alt="플러그인 설치" width="2110" height="1572" data-path="public/en/DifyInstallPlugin.png" />

## 구성

1. 페이지 오른쪽 상단의 아바타 클릭 → '설정' 선택
2. '모델 공급자' 탭 클릭
3. 오른쪽에서 Aihubmix 찾기 → 설정 확장, 그리고 [API 키](https://aihubmix.com/token) 입력

<img src="https://mintlify.s3.us-west-1.amazonaws.com/aihubmix/public/en/enDifySettings1.png" alt="모델 공급자에서 Aihubmix와 API 키 구성하기" />

**현재 다음 5가지 카테고리의 모델이 사전 구성되어 있습니다:**

* LLM: 대규모 언어 모델
* TEXT EMBEDDING: 벡터 임베딩 모델
* RERANK: 재순위 모델
* SPEECH2TEXT: 음성-텍스트 변환 모델
* TTS: 텍스트-음성 변환 모델

<img src="https://mintcdn.com/aihubmix/njYPCqTk0m3HBNaY/public/en/DifyModelsSetting.png?fit=max&auto=format&n=njYPCqTk0m3HBNaY&q=85&s=b15186c4ac987f11e8bc8464a2453adf" alt="모델 설정" width="3110" height="2086" data-path="public/en/DifyModelsSetting.png" />

**더 많은 사용자 지정 모델을 추가하는 방법은?**

'+ 모델 추가'를 클릭하고 모델 이름 옵션을 채웁니다:

* 모델 갤러리의 모든 [모델 ID](https://aihubmix.com/models)를 입력합니다(예: `gpt-4o-2024-11-20`).
* API 키를 입력하고 '저장'을 클릭합니다.

참고: Dify 플러그인의 특수한 설계로 인해 현재 이미지 생성 모델을 지원하지 않으므로 `gpt-image-1`과 같은 모델은 추가할 수 없습니다.

<img src="https://mintcdn.com/aihubmix/njYPCqTk0m3HBNaY/public/en/DifyAddModel.png?fit=max&auto=format&n=njYPCqTk0m3HBNaY&q=85&s=766bee473a046e11ef50ce9502d41041" alt="사용자 지정 모델 추가" width="2600" height="2002" data-path="public/en/DifyAddModel.png" />

## LLM 선택

워크플로우 노드에서 'LLM'을 선택하면 Aihubmix에서 제공하는 모델을 선택할 수 있습니다.

**예시 이미지:**

<img src="https://mintcdn.com/aihubmix/axGkcFk0FkcdXl5v/public/en/LLMs.png?fit=max&auto=format&n=axGkcFk0FkcdXl5v&q=85&s=ca4955f810d6d65837608de77d8f1d4f" alt="LLM 구성" width="3110" height="2086" data-path="public/en/LLMs.png" />

## 임베딩/재순위 모델 선택

임베딩/재순위 모델은 주로 지식 기반 질문 답변에 사용되며, 상단 지식 탭에서 빠르게 경험할 수 있으며 워크플로우 노드에서 해당 모델을 선택할 수도 있습니다.

**예시 이미지:**

<img src="https://mintcdn.com/aihubmix/njYPCqTk0m3HBNaY/public/en/DifyRAG.png?fit=max&auto=format&n=njYPCqTk0m3HBNaY&q=85&s=f3478ae8be084b47f768d3c522993f79" alt="RAG 구성" width="3096" height="2302" data-path="public/en/DifyRAG.png" />

## TTS/SST 선택

TTS/SST 모델은 주로 음성 구문 분석 및 합성에 사용되며, 도구를 선택할 때 해당 항목은 일반적인 'LLM'이 아니라 '도구' 탭의 '오디오' 유형입니다.
대응 관계:

1. TTS 텍스트-음성 변환: 'Text to Speech' 선택
2. SST 음성-텍스트 변환: 'Speech to Text' 선택

**예시 이미지:**

<img src="https://mintcdn.com/aihubmix/axGkcFk0FkcdXl5v/public/en/TTS-SST.png?fit=max&auto=format&n=axGkcFk0FkcdXl5v&q=85&s=1c25021aee0f6fef42261af8941b4322" alt="오디오 구성" width="3110" height="2086" data-path="public/en/TTS-SST.png" />

## Claude 프롬프트 캐싱

Dify에서 본 플러그인을 통해 Claude 모델의 프롬프트 캐싱을 활성화할 수 있습니다. 캐싱할 프롬프트를 `<cache>…</cache>`로 감싸고, 모델 파라미터의 「대용량 메시지 자동 캐시 임계값」을 양의 정수로 설정하세요. 전체 사용법과 캐시 히트 요점은 [Claude 프롬프트 캐싱](./Claude-Cache)을 참고하세요.

***

마지막 업데이트: 2026-06-01