--- title: "Dify 연동" description: "공식 Dify OpenAI-API-compatible 플러그인을 사용하여 1折AI를 구성하는 방법을 다룹니다. 모델 설정, 대화 테스트, 첫 호출 문제 해결까지 안내합니다." headingIds: {"전제 조건":"section-1","모델 추가":"section-2","첫 대화 시작하기":"section-3","예제 Chatflow 가져오기":"section-4","문제 해결":"section-5","연동 지원 받기":"section-6","검증 범위":"section-7","English / Русский":"section-8"} --- Dify 사용자는 공식 **OpenAI-API-compatible** 모델 플러그인을 통해 1折AI의 OpenAI 호환 엔드포인트를 구성할 수 있습니다. 먼저 텍스트 모델을 확인한 다음 워크플로우에서 사용하세요. 검증되지 않은 서드파티 플러그인을 설치할 필요는 없습니다. ## 전제 조건 - 모델 플러그인을 설치할 수 있는 Dify 워크스페이스. - 본인의 1折AI API 키와 해당 키로 호출이 허용된 모델 ID. [콘솔](https://1zheai.com/console)에서 확인하세요. - 계정에 충분한 잔액. 모델 저장 시의 검증 요청과 애플리케이션 테스트는 일반 API 요금이 발생할 수 있습니다. 전체 키를 고객 지원에 보내지 마세요. 워크플로우 설명, 스크린샷, 공개 저장소에 기록하지 마세요. Dify의 API Key 필드에만 저장하세요. 서드파티 호스팅 Dify를 사용하는 경우 해당 인스턴스가 키를 보유하고 요청을 전달합니다. ## 모델 추가 1. Dify 플러그인 마켓플레이스에서 **OpenAI-API-compatible**을 찾고 게시자가 **langgenius**인지 확인하세요. 2. 워크스페이스 설정에서 모델 프로바이더를 열고 이 플러그인을 찾아 LLM 모델을 추가하세요. 3. 아래 항목을 입력하고 저장하세요. 인터페이스 라벨은 Dify 버전에 따라 다를 수 있습니다. | 항목 | 입력 방법 | | --- | --- | | Model Name | 1折AI 콘솔에서 전체 모델 ID를 복사하세요. 표시 이름으로 대체하지 마세요 | | API Key | 본인의 1折AI 키 | | API Base URL | `https://1zheai.com/v1` | | Completion mode | `Chat` | | API 엔드포인트의 모델 이름 | 보통 비워 두세요. 설정하는 경우 실제 모델 ID와 일치해야 합니다 | | 모델 컨텍스트 크기 | 선택한 모델의 실제 능력에 맞춰 입력하세요. 다른 모델의 컨텍스트 길이를 복사하지 마세요 | 여기서는 `/v1`이(가) 필요합니다. 전체 `/v1/chat/completions`을(를) 입력하지 마세요. `/v1/v1`(으)로 중복 입력하지 마세요. 루트 주소만 요구하는 다른 클라이언트의 지침을 적용하지 마세요. ## 첫 대화 시작하기 빈 채팅 앱을 만들고 방금 저장한 모델을 선택한 다음 "한 문장으로 당신이 할 수 있는 일을 중국어로 소개해 주세요."를 입력하세요. 완전한 텍스트 응답이 확인되면 다음으로 스트리밍 출력을 확인하세요. 1折AI 콘솔의 호출 로그에서 해당 요청 시간, 모델, 결과를 확인하세요. 앱이 연결되었다는 증거로 Dify의 "저장되었습니다"만 신뢰하지 마세요. 첫 성공 후에 도구 호출, 비전 입력, 지식 베이스 검색을 구성하세요. 이 기능들은 특정 모델과 인터페이스에 따라 다르며, 텍스트 대화가 성공했다고 해서 모든 것이 사용 가능하다는 의미는 아닙니다. ## 예제 Chatflow 가져오기 [키 없는 Chatflow 템플릿 다운로드](/ko/docs/downloads/1zheai-dify-chatflow.yml)한 다음 Dify Studio에서 **Create → Import DSL file**을 선택하여 업로드하세요. 템플릿은 `User Input → LLM → Answer`이며, DSL 버전은 0.7.0이고 공식 호환 플러그인 0.0.68을 사용합니다. 먼저 위 단계에 따라 본인의 자격 증명을 추가하세요. 가져온 후 LLM 노드를 열고 본인의 프로바이더와 모델이 선택되었는지 확인하세요. Dify의 체험 모델이 선택되면 안 됩니다. 예제 모델 ID는 `claude-haiku-4-5-20251001`입니다. 본인 계정에서 사용할 수 없는 경우 접근 가능한 모델로 전환하고 기능 설정을 확인하세요. 템플릿에는 API 키가 포함되어 있지 않으며 무료 호출 크레딧을 제공하지 않습니다. ## 문제 해결 | 증상 | 먼저 확인할 사항 | | --- | --- | | 503 / 사용 가능한 계정 없음 | 현재 업스트림이 속도 제한이 걸렸거나 용량이 부족할 수 있습니다. 먼저 서비스 상태와 호출 로그를 확인하고, 나중에 백오프를 두고 재시도하거나 지원팀에 문의하세요. 높은 빈도로 계속 재시도하지 마세요. 키를 반복해서 재생성하지 마세요 | | 401 / 잘못된 키 | 추가 공백이 있는지, 키가 취소되었는지, 다른 플랫폼의 키를 실수로 사용했는지 | | 404 | Base URL이 정확히 `https://1zheai.com/v1`인지; 모델 ID가 존재하는지 | | 모델 허용 안 됨 또는 잔액 부족 | 현재 키의 모델 제한, 계정의 가용 잔액, 선택한 모델 | | 저장은 성공했지만 앱이 호출할 수 없음 | 앱이 올바른 프로바이더와 모델을 선택했는지; 워크스페이스 서버가 API에 도달할 수 있는지 | | 일반 응답은 정상, 스트리밍은 실패 | 프록시의 SSE 지원, 플러그인 버전, 스트리밍 사용 설정을 확인하세요. 문제 해결을 위해 마스킹된 오류를 보관하세요 | | 도구 호출 또는 비전 실패 | 먼저 선택한 모델이 해당 기능을 실제로 지원하는지 확인하세요. 플러그인 스위치만 토글하여 강제로 켜지 마세요 | 자체 호스팅 Dify의 요청은 해당 서버에서 전송됩니다. 브라우저에서 공식 사이트를 열 수 있다는 사실이 Dify 서버가 API에 연결할 수 있다는 의미는 아닙니다. ## 연동 지원 받기 공식 사이트의 온라인 고객 지원을 통해 Dify 버전, 플러그인 버전, 모델 ID, 오류 타임스탬프, 요청 ID, 마스킹된 오류 세부 정보를 제공하세요. 전체 키, 고객 데이터, 워크플로우의 비공개 프롬프트를 보내지 마세요. ## 검증 범위 2026-10-19에 공식 플러그인 0.0.68을 사용하여 Dify Cloud에서 Haiku 텍스트 대화와 스트리밍 호출을 완료했고 게이트웨이 로그와 대조했습니다. 내보낸 키 없는 DSL을 동일한 워크스페이스에 새 앱으로 가져왔습니다. 가져온 후 재테스트에서 업스트림 속도 제한으로 인한 503이 발생하여, 이번 라운드는 가져오기 후 실행 통과로 기록되지 않습니다. 이는 정의된 시간 창을 가진 내부 테스트이며 지속적인 가용성 보장이 아닙니다. 새 워크스페이스, 이전 Dify 버전, 도구 호출, 비전, 지식 베이스 검색은 검증되지 않았습니다. 속도 제한이 걸린 본인의 키로 첫 테스트를 완료하세요. [공식 플러그인 소스](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai_api_compatible) · [Dify 플러그인 마켓플레이스](https://marketplace.dify.ai/) ## English / Русский **English:** Install the official OpenAI-API-compatible plugin by langgenius. Set API Base URL to `https://1zheai.com/v1`, use your own API key and an exact model ID available to your account, and select Chat mode. Test a simple conversation before adding tools or vision. Text and streaming calls were verified in Dify Cloud on 2026-10-19. DSL import into a new app in the same workspace succeeded; its subsequent run encountered an upstream-capacity 503. Fresh-workspace import and advanced capabilities remain unverified. Never share your key with support. **Русский:** Установите официальный плагин OpenAI-API-compatible от langgenius. Укажите API Base URL `https://1zheai.com/v1`, собственный API-ключ и точный ID модели, доступной вашему аккаунту; выберите режим Chat. Сначала проверьте простой диалог, затем потоковый вывод. Текстовые и потоковые вызовы проверены в Dify Cloud 19 октября 2026 года. Импорт DSL в новое приложение того же рабочего пространства прошёл, но повторный вызов вернул 503 из-за недоступной мощности upstream. Новое рабочее пространство и расширенные функции ещё не проверены. Не отправляйте ключ службе поддержки. Доступность из конкретной сети и способы оплаты проверяются отдельно.