> ## Documentation Index > Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt > Use this file to discover all available pages before exploring further. # Dify에서 APIMart 사용하기 > Dify LLMOps 플랫폼에서 APIMart API 서비스를 설정하고 사용하는 상세 가이드입니다. 이 가이드는 Dify에서 APIMart API를 설정하여 강력한 AI 애플리케이션을 구축하는 데 도움이 됩니다. ## 준비사항 시작하기 전에 다음을 확인하세요: 1. **Dify 계정 등록 완료** [Dify 공식 웹사이트](https://dify.ai/)를 방문하여 계정을 등록하고 클라우드 또는 자체 호스팅 버전을 선택 2. **APIMart API 키 획득 완료** [APIMart 콘솔](https://apimart.ai/keys)에 로그인하여 API 키(`sk-`로 시작)를 획득 **팁:** APIMart 계정이 아직 없다면, 먼저 [APIMart](https://apimart.ai)에서 등록하고 API 키를 획득하세요. ## 1단계: Dify에 로그인하고 설정 접근 ### 1.1 Dify 플랫폼 접근 * **클라우드 버전:** [https://cloud.dify.ai](https://cloud.dify.ai)를 방문하여 로그인 * **자체 호스팅 버전:** Dify 배포 주소로 접근 Dify 메인 인터페이스 *Dify 메인 인터페이스, 애플리케이션 목록과 앱 만들기 버튼 표시* ### 1.2 모델 설정 페이지로 이동 1. 오른쪽 상단의 **아바타 아이콘** 클릭 2. **설정** 선택 3. 왼쪽 메뉴에서 **모델 공급자** 선택 모델 공급자 설정 페이지 *왼쪽 메뉴에서 "모델 공급자" 옵션 찾기* **참고:** Dify는 여러 모델 공급자 설정을 지원합니다. APIMart를 다른 공급자와 함께 사용할 수 있습니다. ## 2단계: APIMart 모델 공급자 추가 **설정 방법 안내:** Dify에서 APIMart를 설정하는 두 가지 방법이 있습니다: **방법 1(권장):** OpenAI 공급자의 사용자 지정 API 기능 사용 * OpenAI 공급자 설정에서 Base URL을 `https://api.apimart.ai/v1`로 직접 수정 * APIMart API 키 입력 * 더 빠르고 간단한 설정 **방법 2:** 사용자 지정 모델 공급자로 추가(본 가이드 방법) * 더 유연하며 APIMart 공급자를 개별적으로 관리 가능 * 여러 API 공급자를 동시에 사용할 때 편리 두 방법 모두 기능적으로 동일합니다. 선호도에 따라 선택하세요. ### 2.1 설정 방법 선택 #### 방법 1: OpenAI 사용자 지정 API 사용(권장) 1. 모델 공급자 페이지에서 **OpenAI** 공급자 찾기 2. **설정** 버튼 클릭 3. 설정 페이지에서: * **API Key**: APIMart API 키 입력(`sk-xxxxxxxxxxxx`) * **API Base URL** 또는 **Base URL**: `https://api.apimart.ai/v1` 입력 4. **저장** 클릭 OpenAI 사용자 지정 API 설정 OpenAI 사용자 지정 API 설정 *OpenAI 공급자에서 APIMart의 API 키와 Base URL 설정* 5. 설정 완료 후 OpenAI 공급자 페이지로 돌아가 **모델 목록** 확인 6. 모델 목록에서 필요한 모델 찾기(예: `gpt-4o`, `gpt-4o-mini`, `chatgpt-4o-latest` 등) 7. 모델 오른쪽의 **스위치**를 클릭하여 활성화(파란색은 활성화를 나타냄) OpenAI 모델 목록 *OpenAI 모델 목록에서 필요한 모델 활성화* **중요：** APIMart가 실제로 지원하는 모델만 활성화하세요! Dify의 OpenAI 모델 목록에는 많은 모델이 표시되지만, APIMart가 지원하는 모델만 정상적으로 작동합니다. 지원되지 않는 모델을 활성화하면 API 호출이 실패합니다. 지원되는 모델의 전체 목록은 [APIMart API 문서](https://docs.apimart.ai)를 참조하세요. **APIMart 지원 권장 모델:** **GPT 시리즈:** * `gpt-5` / `gpt-5-chat-latest` - GPT-5 시리즈 모델 * `chatgpt-4o-latest` / `gpt-4o` - 최신 GPT-4o 모델 * `gpt-4o-mini` - 빠르고 경제적인 버전 * `gpt-4.1` / `gpt-4.1-mini` - GPT-4.1 시리즈 **Claude 시리즈:** * `claude-sonnet-4-5-20250929` - Claude Sonnet 4.5 * `claude-haiku-4-5-20251001` - Claude Haiku 4.5 **Gemini 시리즈:** * `gemini-2.0-flash-exp` - Google Gemini 2.0 Flash 여러 모델을 동시에 활성화하여 애플리케이션에서 유연하게 전환하여 사용할 수 있습니다. 완료 후 바로 사용할 수 있습니다. **3단계**로 이동하세요. #### 방법 2: 사용자 지정 모델 공급자 추가 모델 공급자 페이지에서: 1. **사용자 지정 모델** 섹션으로 스크롤 2. **+ 모델 추가** 버튼 클릭 사용자 지정 모델 섹션 *사용자 지정 모델 섹션으로 스크롤하여 "+ 모델 추가" 버튼 클릭* ### 2.2 APIMart 공급자 설정 설정 대화상자에서 다음 정보를 입력: | 필드 | 값 | | -------------------- | ------------------------------------------------------------------------- | | **모델 이름** | `APIMart` 또는 사용자 지정 이름 | | **모델 유형** | `LLM`(대규모 언어 모델) 선택 | | **API Key** | APIMart API 키(`sk-xxxxxxxxxxxx`) | | **API endpoint URL** | `https://api.apimart.ai/v1` | | **Endpoint 모델 이름** | 구체적인 모델 이름 입력(예: `gpt-4o`, `gpt-4o-mini`, `claude-sonnet-4-5-20250929` 등) | 공급자 추가 대화상자 *APIMart 공급자 설정 정보 입력* **중요:** * Base URL에는 `/v1` 접미사가 포함되어야 합니다: `https://api.apimart.ai/v1` * API 키는 APIMart 콘솔에서 획득한 `sk-`로 시작하는 키여야 합니다 * API 키에 충분한 잔액이 있는지 확인하세요 ### 2.3 더 많은 모델 추가(선택 사항) 더 많은 모델을 추가하려면 위 단계를 반복: 1. 사용자 지정 모델 섹션에서 **+ 모델 추가** 버튼을 다시 클릭 2. 다른 모델의 설정 정보 입력 3. 저장 클릭 *모델 추가 단계를 반복하여 여러 개의 서로 다른 모델을 설정할 수 있습니다* **추가 권장 모델:** #### GPT-4/5 시리즈 | 모델 ID | 모델 이름 | 컨텍스트 길이 | 사용 사례 | | ------------- | ----------- | ------- | ---------------- | | `gpt-5` | GPT-5 | 128,000 | 복잡한 작업, 긴 텍스트 처리 | | `gpt-4o` | GPT-4o | 128,000 | 고품질 대화, 코드 생성 | | `gpt-4o-mini` | GPT-4o Mini | 128,000 | 빠른 응답, 비용 효율적 | #### Claude 시리즈 | 모델 ID | 모델 이름 | 컨텍스트 길이 | 사용 사례 | | ---------------------------- | ----------------- | ------- | ------------- | | `claude-sonnet-4-5-20250929` | Claude Sonnet 4.5 | 200,000 | 복잡한 추론, 코드 분석 | | `claude-haiku-4-5-20251001` | Claude Haiku 4.5 | 200,000 | 빠른 응답, 간단한 작업 | #### Gemini 시리즈 | 모델 ID | 모델 이름 | 컨텍스트 길이 | 사용 사례 | | ---------------------- | ---------------- | ------- | ---------------- | | `gemini-2.0-flash-exp` | Gemini 2.0 Flash | 32,000 | 멀티모달, 실시간 애플리케이션 | **성능 권장사항:** * 💰 **비용 효율적:** `gpt-4o-mini`, `claude-haiku-4-5-20251001` * 🚀 **고성능:** `gpt-5`, `gpt-4o`, `claude-sonnet-4-5-20250929` * ⚡ **빠른 응답:** `gemini-2.0-flash-exp`, `gpt-4o-mini` ## 3단계: 애플리케이션에서 APIMart 모델 사용 ### 3.1 새 애플리케이션 만들기 1. Dify 홈페이지로 돌아가기 2. **앱 만들기** 버튼 클릭 3. 애플리케이션 유형 선택: * **챗봇** - 대화형 애플리케이션 * **텍스트 생성기** - 텍스트 생성 애플리케이션 * **에이전트** - 지능형 에이전트 * **워크플로우** - 복잡한 워크플로우 애플리케이션 애플리케이션 만들기 *애플리케이션 유형을 선택하여 새 앱을 만듭니다* ### 3.2 APIMart 모델 선택 애플리케이션 오케스트레이션 페이지에서: 1. **모델 설정** 영역 찾기 2. **모델 선택** 드롭다운 클릭 3. **APIMart** 공급자 선택 4. 설정한 모델 선택(예: `gpt-4o`) APIMart 모델 선택 *애플리케이션에서 APIMart 공급자의 모델을 선택합니다* ### 3.3 모델 매개변수 설정 필요에 따라 모델 매개변수 조정: | 매개변수 | 설명 | 권장 값 | | --------------------- | ---------- | ------------------- | | **Temperature** | 출력 무작위성 제어 | 0.7(창의적) / 0.3(정확한) | | **Max Tokens** | 최대 출력 길이 | 2000-4000 | | **Top P** | 핵 샘플링 매개변수 | 0.9 | | **Presence Penalty** | 반복 감소 | 0.0-0.5 | | **Frequency Penalty** | 빈번한 단어 감소 | 0.0-0.5 | 모델 매개변수 설정 *애플리케이션 요구 사항에 따라 모델 매개변수를 조정합니다* ## 4단계: 애플리케이션 구축 및 테스트 ### 4.1 프롬프트 추가 애플리케이션 오케스트레이션 페이지에서: 1. **시스템 프롬프트** 영역에 프롬프트 작성 2. 변수를 사용하여 앱을 동적으로 만들기: * `{{variable_name}}` - 사용자 입력 변수 * `{{context}}` - 지식 베이스 컨텍스트 **프롬프트 예시:** ``` 당신은 제품에 관한 질문에 답변하는 데 능숙한 전문 고객 서비스 도우미입니다. 제품 정보: {{product_info}} 사용자 질문에 따라 정확하고 친근한 답변을 제공하세요. 확실하지 않은 경우 정직하게 사용자에게 알려주세요. 사용자 질문: {{user_question}} ``` 프롬프트 편집기 *프롬프트 편집기에서 프롬프트를 작성하고 설정합니다* ### 4.2 지식 베이스 추가(선택 사항) RAG(검색 증강 생성) 기능이 필요한 경우: 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 사용 모니터링 [APIMart 콘솔](https://apimart.ai/overview)에 로그인하여 확인: * 📊 **API 호출 통계** - 총 호출 수, 성공률 * 💰 **비용 세부정보** - 일일/월간 비용 * 📈 **사용 추세** - 사용량 변화 추세 * 🔍 **요청 로그** - 상세한 요청 기록 ### 5.3 애플리케이션 성능 최적화 모니터링 데이터를 기반으로 최적화: 1. **모델 선택 조정** * 간단한 작업에는 `gpt-4o-mini`를 사용하여 비용 절감 * 복잡한 작업에는 `gpt-4o` 또는 `claude-sonnet-4-5`를 사용하여 품질 향상 2. **프롬프트 최적화** * 프롬프트를 더 명확하고 구체적으로 만들기 * 예제를 추가하여 효과 향상 * 사고의 연쇄를 사용하여 추론 능력 향상 3. **캐싱 설정** * 유사한 질문에 대해 캐싱 활성화 * API 호출 비용 절감 ## 고급 기능 ### 워크플로우 오케스트레이션 사용 Dify의 워크플로우 기능을 사용하면 다음을 수행할 수 있습니다: 1. **조건 분기** - 조건에 따라 다른 로직 실행 2. **다중 모델 협업** - 여러 모델의 장점을 결합 3. **외부 도구 호출** - API, 데이터베이스 등 외부 리소스 호출 4. **변수 전달** - 서로 다른 노드 간 데이터 전달 ### Agent 기능 설정 APIMart 모델을 사용하여 지능형 Agent 구축: 1. **도구 호출** - AI가 외부 도구를 호출하도록 설정 2. **메모리 관리** - 장기 대화 기억 유지 3. **자율 의사결정** - AI가 실행 단계를 자율적으로 계획 ### 멀티모달 애플리케이션 APIMart의 멀티모달 기능과 결합: 1. **이미지 이해** - `gpt-4o` 또는 `claude-3`를 사용하여 이미지 처리 2. **이미지 생성** - APIMart의 이미지 생성 API 통합 3. **음성 처리** - TTS 및 STT 서비스 통합 ## 자주 묻는 질문 ### Q1: APIMart 서비스에 연결할 수 없습니까? **해결책:** 1. **Base URL 확인**: * `https://api.apimart.ai/v1`(`/v1` 포함)인지 확인 * 추가 경로를 추가하거나 `/v1`을 생략하지 마세요 2. **API 키 확인**: * API 키가 `sk-`로 시작하는지 확인 * [APIMart 콘솔](https://apimart.ai/keys)에서 키가 유효한지 확인 3. **네트워크 연결 확인**: * 서버가 `https://api.apimart.ai`에 액세스할 수 있는지 확인 * 자체 호스팅 버전의 경우 서버 네트워크 연결 확인 ### Q2: 모델 응답이 느립니까? **해결책:** 1. **더 빠른 모델로 전환**: * `gpt-4o` 대신 `gpt-4o-mini` 사용 * 더 빠른 응답을 위해 `gemini-2.0-flash-exp` 사용 2. **프롬프트 길이 최적화**: * 불필요한 컨텍스트 줄이기 * 프롬프트 설명 단순화 3. **지식 베이스 검색 조정**: * 검색 문서 수 줄이기 * 유사도 임계값 높이기 ### Q3: API 호출이 실패하거나 오류를 반환합니까? **일반적인 오류 및 해결책:** | 오류 메시지 | 원인 | 해결 방법 | | --------------------------- | ------------------ | --------------------------- | | `401 Unauthorized` | 유효하지 않거나 만료된 API 키 | API 키를 다시 받고 설정 업데이트 | | `429 Too Many Requests` | 요청 속도 제한 초과 | 앱 동시성 설정 조정 또는 대기 후 재시도 | | `500 Internal Server Error` | 일시적인 서버 문제 | 몇 분 기다린 후 재시도 | | `insufficient_quota` | 계정 잔액 부족 | 콘솔에서 충전 | | `context_length_exceeded` | 입력이 컨텍스트 길이 초과 | 입력 길이를 줄이거나 더 큰 컨텍스트의 모델 사용 | ### Q4: API 사용 비용을 낮추려면 어떻게 해야 합니까? **비용 최적화 권장사항:** 1. **모델 선택**: * 간단한 작업에는 `gpt-4o-mini` 사용(`gpt-4o` 비용의 약 1/10) * 배치 작업에는 더 경제적인 모델 사용 고려 2. **캐시 활성화**: * 동일한 질문에는 캐시된 결과 반환 * Dify에서 유사도 매칭 설정 3. **출력 길이 최적화**: * 적절한 Max Tokens 설정 * 지나치게 긴 응답 생성을 피하기 4. **스트리밍 출력 사용**: * 비용을 늘리지 않으면서 사용자 경험 개선 ### Q5: 민감한 데이터는 어떻게 처리해야 합니까? **데이터 보안 권장사항:** 1. **환경 변수 사용**: * 코드에 API Key를 하드코딩하지 않기 * Dify의 환경 변수 기능 사용 2. **접근 제어 설정**: * 애플리케이션 접근 권한 설정 * API 호출 시 인증 활성화 3. **감사 로그**: * 애플리케이션 로그를 정기적으로 확인 * 비정상적인 접근 패턴 모니터링 ## 모범 사례 ### 1. 프롬프트 엔지니어링 **구조화된 프롬프트:** ``` # 역할 정의 당신은 전문적인 [역할 설명]입니다 # 작업 목표 사용자의 [작업 설명]을 도와야 합니다 # 출력 요구사항 - 요구사항1 - 요구사항2 - 요구사항3 # 입력 정보 {{user_input}} ``` ### 2. 지식 베이스 관리 * **청크 전략**: 문서 청크 크기를 적절히 설정(권장 500-1000자) * **메타데이터 태깅**: 검색이 쉽도록 문서에 메타데이터 추가 * **정기 업데이트**: 지식 베이스 콘텐츠를 최신 상태로 유지 ### 3. 오류 처리 * **친절한 안내**: 사용자에게 명확한 오류 메시지 제공 * **대체 전략**: 기본 모델 실패 시 예비 모델로 전환 * **재시도 메커니즘**: 일시적인 오류를 자동으로 재시도 ### 4. 성능 모니터링 * **알림 설정**: 잔액 부족 또는 오류율 증가 시 알림 * **정기 분석**: 주간/월간 사용 데이터 분석 * **지속적인 최적화**: 데이터에 따라 설정 조정 ## 사용 사례 예시 ### 1. 지능형 고객 지원 **애플리케이션 설정:** * 모델: `gpt-4o-mini`(높은 비용 효율) * 지식 베이스: 제품 문서, FAQ * 기능: 자주 묻는 질문 자동 답변, 복잡한 질문은 상담원에게 전환 ### 2. 콘텐츠 제작 도우미 **애플리케이션 설정:** * 모델: `gpt-4o` 또는 `claude-sonnet-4-5`(고품질) * 기능: 글 생성, 재작성, 교정 * 매개변수: Temperature=0.8(창의성 향상) ### 3. 코드 도우미 **애플리케이션 설정:** * 모델: `claude-sonnet-4-5`(코드에 강함) * 기능: 코드 생성, 설명, 디버깅 * 지식 베이스: 프로젝트 문서, API 문서 ### 4. 데이터 분석 도우미 **애플리케이션 설정:** * 모델: `gpt-4o`(강력한 추론 능력) * 도구: Python 코드 실행, 데이터 시각화 * 기능: 데이터 분석, 보고서 생성 ## 기능 특성 Dify + APIMart를 사용하면 다음을 수행할 수 있습니다: * 🤖 **AI 애플리케이션 빠르게 구축** - 코딩 없이 강력한 AI 애플리케이션 생성 * 📚 **지식 베이스 강화** - RAG 기술로 AI가 자체 데이터에 기반해 답변 * 🔧 **유연한 워크플로우** - 복잡한 AI 로직을 시각적으로 오케스트레이션 * 🎯 **정밀한 프롬프트 관리** - 버전 관리 및 A/B 테스트 * 📊 **완전한 모니터링 분석** - 애플리케이션 사용 현황과 성능 파악 * 🔌 **다양한 통합 방식** - API, 임베드, WebApp 등 다양한 방식 * 👥 **팀 협업** - 여러 사람이 함께 애플리케이션 개발 가능 * 🌐 **다중 모델 지원** - 서로 다른 AI 모델을 유연하게 전환 ## 지원 및 도움말 문제가 발생한 경우: * 📚 [APIMart 문서](https://docs.apimart.ai) * 📚 [Dify 공식 문서](https://docs.dify.ai) * 💬 [Discord 커뮤니티](https://discord.gg/V8zqssyZ5c) * 🐦 [Twitter @APIMart\_](https://x.com/APIMart_) * 📧 기술 지원: [zhihong@apimart.ai](mailto:zhihong@apimart.ai) *** 지금 APIMart에 등록하고 API 키를 받아 Dify에서 강력한 AI 애플리케이션을 구축하세요!