Dify 연동

공식 Dify OpenAI-API-compatible 플러그인을 사용하여 1折AI를 구성하는 방법을 다룹니다. 모델 설정, 대화 테스트, 첫 호출 문제 해결까지 안내합니다.

Dify 사용자는 공식 OpenAI-API-compatible 모델 플러그인을 통해 1折AI의 OpenAI 호환 엔드포인트를 구성할 수 있습니다. 먼저 텍스트 모델을 확인한 다음 워크플로우에서 사용하세요. 검증되지 않은 서드파티 플러그인을 설치할 필요는 없습니다.

전제 조건

모델 플러그인을 설치할 수 있는 Dify 워크스페이스.
본인의 1折AI API 키와 해당 키로 호출이 허용된 모델 ID. 콘솔에서 확인하세요.
계정에 충분한 잔액. 모델 저장 시의 검증 요청과 애플리케이션 테스트는 일반 API 요금이 발생할 수 있습니다.

전체 키를 고객 지원에 보내지 마세요. 워크플로우 설명, 스크린샷, 공개 저장소에 기록하지 마세요. Dify의 API Key 필드에만 저장하세요. 서드파티 호스팅 Dify를 사용하는 경우 해당 인스턴스가 키를 보유하고 요청을 전달합니다.

모델 추가

Dify 플러그인 마켓플레이스에서 OpenAI-API-compatible을 찾고 게시자가 langgenius인지 확인하세요.
워크스페이스 설정에서 모델 프로바이더를 열고 이 플러그인을 찾아 LLM 모델을 추가하세요.
아래 항목을 입력하고 저장하세요. 인터페이스 라벨은 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 템플릿 다운로드한 다음 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 버전, 도구 호출, 비전, 지식 베이스 검색은 검증되지 않았습니다. 속도 제한이 걸린 본인의 키로 첫 테스트를 완료하세요.

공식 플러그인 소스 · Dify 플러그인 마켓플레이스

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. Новое рабочее пространство и расширенные функции ещё не проверены. Не отправляйте ключ службе поддержки. Доступность из конкретной сети и способы оплаты проверяются отдельно.