빠른 연동
1. API 키 발급
APIYI 콘솔에 접속하여 API 키를 발급받으십시오.2. 모델 제공자 설정
- Dify 플랫폼에 로그인합니다.
- 사용자 이름 > 설정을 클릭합니다.
- “모델 제공자”를 선택하고 OpenAI-API-compatible을 선택합니다.
- 모델 유형에 따라 설정 방식을 선택합니다.

GPT, Claude, Gemini를 포함한 모든 모델 설정
- 모델 유형: LLM 유형을 선택합니다(첫 번째 열, 이미지 생략).
-
모델 이름: 임의로 입력해서는 안 되며, 반드시 표준 모델 이름을 입력해야 합니다.
- 예시: Gemini 2.5 Flash 대신 gemini-2.5-flash를 입력합니다.
- 모델 표시 이름: Gemini 2.5 Flash와 같이 쉽게 식별할 수 있도록 자유롭게 입력할 수 있습니다.
- API 키: APIYI 키를 입력합니다.
-
API 엔드포인트 URL:
https://api.apiyi.com/v1 - API 엔드포인트의 모델 이름: gemini-2.5-flash와 같은 표준 이름을 사용합니다.



핵심 기능
채팅 어시스턴트
지능형 채팅 어시스턴트를 생성합니다:- “Chat Assistant” 템플릿을 선택합니다
- 시스템 prompt를 설정합니다:
- 적절한 모델을 선택합니다(예: GPT-4)
- 파라미터를 조정합니다:
- Temperature: 0.7(창의성과 정확성의 균형)
- Max Output: 2000 tokens
워크플로 애플리케이션
복잡한 AI 워크플로를 구축합니다:지식 베이스 Q&A
문서 지식 베이스를 통합합니다:- 지식 베이스를 생성합니다
- 문서를 업로드합니다(PDF, Word, Markdown)
- 임베딩 모델을 선택합니다:
text-embedding-ada-002 - 애플리케이션에서 지식 베이스를 참조합니다
- 검색 파라미터를 설정합니다:
- 검색 개수: 3-5 세그먼트
- 유사도 임계값: 0.7
- Reranking: 활성화됨
애플리케이션 유형
1. 채팅 어시스턴트
2. 문서 분석
3. 코드 어시스턴트
고급 기능
API 통합
Dify 애플리케이션은 API를 통해 호출할 수 있습니다:일괄 처리
대량의 데이터를 처리합니다:- CSV 파일을 준비합니다
- 일괄 작업을 생성합니다
- 처리 템플릿을 구성합니다
- 일괄 작업을 실행합니다
- 결과를 내보냅니다
멀티모달 애플리케이션
텍스트와 이미지를 혼합하여 처리할 수 있습니다:모델 선택 전략
시나리오별 선택
비용 최적화
모범 사례
1. Prompt 최적화
2. 워크플로 설계
3. 모니터링 및 최적화
정기 점검:- 사용자 만족도 피드백
- 응답 시간 통계
- 비용 사용량
- 오류율 분석
4. 버전 관리
- 애플리케이션 구성을 정기적으로 백업합니다
- 배포 전에 새 버전을 테스트합니다
- 롤백을 위해 여러 버전을 유지합니다
문제 해결
일반적인 문제
모델 호출 실패
- API 키의 정확성을 확인합니다
- 충분한 계정 잔액을 확인합니다
- 네트워크 연결을 확인합니다
응답 품질 저하
- prompt 설계를 최적화합니다
- 모델 매개변수를 조정합니다
- 컨텍스트 정보를 추가합니다
성능 문제
- 더 빠른 모델을 선택합니다
- 출력 길이 제한을 줄입니다
- 캐싱을 활성화합니다
성능 최적화
배포 권장 사항
프로덕션 환경
보안 구성
- 민감한 정보는 환경 변수를 사용하여 저장합니다
- HTTPS 액세스를 활성화합니다
- 접근 제어를 설정합니다
- 종속성을 정기적으로 업데이트합니다