Open WebUI

Open WebUI는 완전 오프라인 동작을 지원하는 기능이 풍부한 자체 호스팅 AI 플랫폼입니다. APIYI를 통해 Open WebUI에 다양한 주류 대규모 언어 모델을 통합할 수 있습니다.

빠른 배포

Docker 빠른 시작

docker run -d -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

Docker Compose 배포

version: '3.6'

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    ports:
      - "3000:8080"
    volumes:
      - open-webui:/app/backend/data
    environment:
      - OPENAI_API_BASE_URL=https://api.apiyi.com
      - OPENAI_API_KEY=Your APIYI key
    restart: unless-stopped

volumes:
  open-webui:

APIYI 설정

방법 1: 환경 변수 설정

배포 중 환경 변수를 설정합니다:

docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.apiyi.com \
  -e OPENAI_API_KEY=Your APIYI key \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

방법 2: 인터페이스 설정

Open WebUI 관리자 인터페이스에 접속합니다
설정 > 연결로 이동합니다
OpenAI API 섹션에서 설정합니다:
- API Base URL: https://api.apiyi.com/v1
- API Key: APIYI 키를 입력합니다
설정을 저장합니다

설정 핵심 포인트

API Base URL에는 /v1 접미사가 포함되어야 합니다
API Key는 APIYI 콘솔에서 확인할 수 있습니다
더 쉽게 관리하고 업데이트하려면 환경 변수 방식을 사용하는 것이 권장됩니다

지원 모델

Open WebUI는 APIYI를 통해 다음 모델 시리즈를 지원합니다.

모델 시리즈	Model ID	기능
GPT-4 Turbo	`gpt-4-turbo-2024-04-09`	최신 GPT-4, 균형 잡힌 성능
Claude Sonnet	`claude-sonnet-4-20250514`	긴 텍스트 처리, 창의적 글쓰기
Gemini Pro	`gemini-2.5-pro`	멀티모달 기능, 빠른 응답
GPT-3.5 Turbo	`gpt-3.5-turbo`	경제적이고 실용적이며, 일상 대화에 적합함

주요 기능 모델

기능	추천 모델	설명
Vision Understanding	`gpt-4-vision-preview`	이미지 분석 및 이해
Code Generation	`gpt-4-turbo`	프로그래밍 지원 및 코드 최적화
Reasoning Thinking	`claude-sonnet-4-20250514-thinking`	사고 과정을 보여줌

핵심 기능

RAG (검색 증강 생성)

Open WebUI는 문서 업로드 및 지식 베이스 기능을 지원합니다.

문서 업로드
- PDF, TXT, DOCX 및 기타 형식을 지원합니다
- 자동 벡터화 저장
- 다국어 문서를 지원합니다
지식 베이스 관리
- 전문 지식 베이스를 생성합니다
- 문서 분류 및 태깅
- 지능형 검색 매칭

OpenAI 호환 API

Open WebUI는 완전한 OpenAI 호환 API를 제공합니다:

# Chat completion
curl -X POST "http://localhost:3000/api/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer Your APIYI key" \
  -d '{
    "model": "gpt-4-turbo",
    "messages": [
      {"role": "user", "content": "Hello, world!"}
    ]
  }'

도구 통합

외부 도구 및 플러그인을 지원합니다:

웹 검색
코드 실행
이미지 생성
문서 처리

고급 설정

다중 모델 구성

docker-compose.yml에서 여러 모델 소스를 구성합니다:

environment:
  - OPENAI_API_BASE_URL=https://api.apiyi.com
  - OPENAI_API_KEY=Your APIYI key
  - ENABLE_OPENAI_API=true
  - ENABLE_OLLAMA_API=false

사용자 권한 관리

environment:
  - ENABLE_SIGNUP=false
  - DEFAULT_USER_ROLE=user
  - WEBHOOK_URL=Your webhook address

데이터 지속성

volumes:
  - open-webui:/app/backend/data
  - ./uploads:/app/backend/data/uploads
  - ./vector_db:/app/backend/data/vector_db

API 통합 예시

Python 통합

import requests

# Open WebUI API endpoint
api_url = "http://localhost:3000/api/chat/completions"

# Request configuration
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer Your APIYI key"
}

data = {
    "model": "gpt-4-turbo",
    "messages": [
        {"role": "user", "content": "Explain the basic principles of quantum computing"}
    ],
    "stream": False
}

# Send request
response = requests.post(api_url, headers=headers, json=data)
result = response.json()
print(result["choices"][0]["message"]["content"])

JavaScript 통합

const apiUrl = 'http://localhost:3000/api/chat/completions';

const requestData = {
  model: 'gpt-4-turbo',
  messages: [
    { role: 'user', content: 'Write a simple Python function' }
  ]
};

fetch(apiUrl, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer Your APIYI key'
  },
  body: JSON.stringify(requestData)
})
.then(response => response.json())
.then(data => {
  console.log(data.choices[0].message.content);
});

문제 해결

일반적인 문제

연결 실패

API Base URL이 올바른지 확인하십시오: https://api.apiyi.com/v1
API Key 유효성을 확인하십시오
방화벽 설정을 확인하십시오

모델을 사용할 수 없음

잔액을 확인하십시오
모델이 서비스 범위 내에 있는지 확인하십시오
APIYI 서비스 상태를 확인하십시오

업로드 실패

파일 형식 지원 여부를 확인하십시오
충분한 저장 공간이 있는지 확인하십시오
파일 크기 제한을 확인하십시오

로그 디버깅

디버그 모드를 활성화하십시오:

docker logs -f open-webui

상세 로그를 확인하십시오:

environment:
  - LOG_LEVEL=DEBUG
  - WEBUI_DEBUG=true

모범 사례

성능 최적화

모델 선택
- 일상 대화에는 GPT-3.5 Turbo를 사용합니다
- 복잡한 작업에는 GPT-4 Turbo를 사용합니다
- 긴 텍스트 처리에는 Claude Sonnet을 사용합니다
캐싱 전략
- 대화 캐싱을 활성화합니다
- 적절한 캐시 만료 시간을 설정합니다
- 사용하지 않는 캐시는 정기적으로 정리합니다
리소스 관리
- 메모리 사용량을 모니터링합니다
- 적절한 동시 실행 수 제한을 설정합니다
- 사용자 데이터를 정기적으로 백업합니다

보안 구성

environment:
  - ENABLE_ADMIN_EXPORT=false
  - ENABLE_ADMIN_CHAT_ACCESS=false
  - JWT_EXPIRES_IN=7d

모니터링 알림

모니터링 시스템을 연동합니다:

environment:
  - ENABLE_WEBHOOKS=true
  - WEBHOOK_URL=https://your-monitoring-url

더 많은 도움이 필요하신가요? Open WebUI 공식 문서를 확인하시거나 APIYI 공식 웹사이트를 방문해 보세요.

개요

대화형 AI

프로그래밍

커뮤니티 기여

AI 에이전트

엔지니어링

번역

빠른 배포

Docker 빠른 시작

Docker Compose 배포

APIYI 설정

방법 1: 환경 변수 설정

방법 2: 인터페이스 설정

지원 모델

추천 모델

주요 기능 모델

핵심 기능

RAG (검색 증강 생성)

OpenAI 호환 API

도구 통합

고급 설정

다중 모델 구성

사용자 권한 관리

데이터 지속성

API 통합 예시

Python 통합

JavaScript 통합

문제 해결

일반적인 문제

로그 디버깅

모범 사례

성능 최적화

보안 구성

모니터링 알림

​빠른 배포

​Docker 빠른 시작

​Docker Compose 배포

​APIYI 설정

​방법 1: 환경 변수 설정

​방법 2: 인터페이스 설정

​지원 모델

​추천 모델

​주요 기능 모델

​핵심 기능

​RAG (검색 증강 생성)

​OpenAI 호환 API

​도구 통합

​고급 설정

​다중 모델 구성

​사용자 권한 관리

​데이터 지속성

​API 통합 예시

​Python 통합

​JavaScript 통합

​문제 해결

​일반적인 문제

​로그 디버깅

​모범 사례

​성능 최적화

​보안 구성

​모니터링 알림

빠른 배포

Docker 빠른 시작

Docker Compose 배포

APIYI 설정

방법 1: 환경 변수 설정

방법 2: 인터페이스 설정

지원 모델

추천 모델

주요 기능 모델

핵심 기능

RAG (검색 증강 생성)

OpenAI 호환 API

도구 통합

고급 설정

다중 모델 구성

사용자 권한 관리

데이터 지속성

API 통합 예시

Python 통합

JavaScript 통합

문제 해결

일반적인 문제

로그 디버깅

모범 사례

성능 최적화

보안 구성

모니터링 알림