Dify에서 ElkAPI 사용하기

​

준비사항

1. Dify 계정 등록 완료
   Dify 공식 웹사이트를 방문하여 계정을 등록하고 클라우드 또는 자체 호스팅 버전을 선택
2. ElkAPI API 키 획득 완료
   ElkAPI 콘솔에 로그인하여 API 키(sk-로 시작)를 획득

​

1단계: Dify에 로그인하고 설정 접근

​

1.1 Dify 플랫폼 접근

• 클라우드 버전: https://cloud.dify.ai를 방문하여 로그인
• 자체 호스팅 버전: Dify 배포 주소로 접근

​

1.2 모델 설정 페이지로 이동

1. 오른쪽 상단의 아바타 아이콘 클릭
2. 설정 선택
3. 왼쪽 메뉴에서 모델 공급자 선택

​

2단계: ElkAPI 모델 공급자 추가

​

2.1 설정 방법 선택

​

방법 1: OpenAI 사용자 지정 API 사용(권장)

1. 모델 공급자 페이지에서 OpenAI 공급자 찾기
2. 설정 버튼 클릭
3. 설정 페이지에서:
   • API Key: ElkAPI API 키 입력(sk-xxxxxxxxxxxx)
   • API Base URL 또는 Base URL: https://api.elkapi.com/v1 입력
4. 저장 클릭

5. 설정 완료 후 OpenAI 공급자 페이지로 돌아가 모델 목록 확인
6. 모델 목록에서 필요한 모델 찾기(예: gpt-5.5, gpt-5.4-mini, gpt-5.5 등)
7. 모델 오른쪽의 스위치를 클릭하여 활성화(파란색은 활성화를 나타냄)

​

방법 2: 사용자 지정 모델 공급자 추가

1. 사용자 지정 모델 섹션으로 스크롤
2. + 모델 추가 버튼 클릭

​

2.2 ElkAPI 공급자 설정

​

2.3 더 많은 모델 추가(선택 사항)

1. 사용자 지정 모델 섹션에서 + 모델 추가 버튼을 다시 클릭
2. 다른 모델의 설정 정보 입력
3. 저장 클릭

​

GPT-4/5 시리즈

​

Claude 시리즈

​

Gemini 시리즈

​

3단계: 애플리케이션에서 ElkAPI 모델 사용

​

3.1 새 애플리케이션 만들기

1. Dify 홈페이지로 돌아가기
2. 앱 만들기 버튼 클릭
3. 애플리케이션 유형 선택:
   • 챗봇 - 대화형 애플리케이션
   • 텍스트 생성기 - 텍스트 생성 애플리케이션
   • 에이전트 - 지능형 에이전트
   • 워크플로우 - 복잡한 워크플로우 애플리케이션

​

3.2 ElkAPI 모델 선택

1. 모델 설정 영역 찾기
2. 모델 선택 드롭다운 클릭
3. ElkAPI 공급자 선택
4. 설정한 모델 선택(예: gpt-5.5)

​

3.3 모델 매개변수 설정

​

4단계: 애플리케이션 구축 및 테스트

​

4.1 프롬프트 추가

1. 시스템 프롬프트 영역에 프롬프트 작성
2. 변수를 사용하여 앱을 동적으로 만들기:
   • {{variable_name}} - 사용자 입력 변수
   • {{context}} - 지식 베이스 컨텍스트

당신은 제품에 관한 질문에 답변하는 데 능숙한 전문 고객 서비스 도우미입니다.

제품 정보: {{product_info}}

사용자 질문에 따라 정확하고 친근한 답변을 제공하세요. 확실하지 않은 경우 정직하게 사용자에게 알려주세요.

사용자 질문: {{user_question}}

​

4.2 지식 베이스 추가(선택 사항)

1. 왼쪽 메뉴에서 지식 베이스 클릭
2. 새 지식 베이스를 만들고 문서 업로드
3. 애플리케이션 오케스트레이션 페이지에서 지식 베이스 연결
4. 검색 매개변수 설정

​

4.3 애플리케이션 테스트

1. 오른쪽 미리보기 패널에 테스트 질문 입력
2. AI 응답 효과 검토
3. 필요에 따라 프롬프트와 매개변수 조정
4. 만족할 때까지 테스트 반복

​

4.4 애플리케이션 게시

1. 오른쪽 상단의 게시 버튼 클릭
2. 게시 방법 선택:
   • API 호출 - API를 통한 통합
   • 웹사이트에 임베드 - 임베드 코드 생성
   • 공개 링크 - 공유 링크 생성

​

5단계: 모니터링 및 최적화

​

5.1 애플리케이션 로그 보기

1. 로그 탭 클릭
2. 모든 대화 기록 보기
3. 사용자 질문 및 AI 응답 분석
4. 개선 기회 발견

​

5.2 API 사용 모니터링

• 📊 API 호출 통계 - 총 호출 수, 성공률
• 💰 비용 세부정보 - 일일/월간 비용
• 📈 사용 추세 - 사용량 변화 추세
• 🔍 요청 로그 - 상세한 요청 기록

​

5.3 애플리케이션 성능 최적화

1. 모델 선택 조정
   • 간단한 작업에는 gpt-5.4-mini를 사용하여 비용 절감
   • 복잡한 작업에는 gpt-5.5 또는 claude-sonnet-4-6를 사용하여 품질 향상
2. 프롬프트 최적화
   • 프롬프트를 더 명확하고 구체적으로 만들기
   • 예제를 추가하여 효과 향상
   • 사고의 연쇄를 사용하여 추론 능력 향상
3. 캐싱 설정
   • 유사한 질문에 대해 캐싱 활성화
   • API 호출 비용 절감

​

자주 묻는 질문

​

Q1: ElkAPI 서비스에 연결할 수 없습니까?

1. Base URL 확인:
   • https://api.elkapi.com/v1(/v1 포함)인지 확인
   • 추가 경로를 추가하거나 /v1을 생략하지 마세요
2. API 키 확인:
   • API 키가 sk-로 시작하는지 확인
   • ElkAPI 콘솔에서 키가 유효한지 확인
3. 네트워크 연결 확인:
   • 서버가 https://api.elkapi.com에 액세스할 수 있는지 확인
   • 자체 호스팅 버전의 경우 서버 네트워크 연결 확인

​

Q2: 모델 응답이 느립니까?

1. 더 빠른 모델로 전환:
   • gpt-5.5 대신 gpt-5.4-mini 사용
   • 더 빠른 응답을 위해 gemini-3.1-flash-lite-preview 사용
2. 프롬프트 길이 최적화:
   • 불필요한 컨텍스트 줄이기
   • 프롬프트 설명 단순화
3. 지식 베이스 검색 조정:
   • 검색 문서 수 줄이기
   • 유사도 임계값 높이기

​

Q3: API 호출이 실패하거나 오류를 반환합니까?

​

지원 및 도움말

• 📚 ElkAPI 문서
• 📚 Dify 공식 문서
• 📧 기술 지원: support@elkapi.com