본문으로 건너뛰기
개발자 리소스
개발자 리소스

Open WebUI

Open WebUI를 설치하고, RunAPI를 OpenAI 호환 연결로 추가하고, 모델을 선택하고, 채팅을 확인합니다.

Markdown 보기

OpenAI 호환 Connection을 통해 Open WebUI를 RunAPI에 연결합니다. Open WebUI 관리자 액세스와 인증 가이드에서 발급한 표준 RunAPI API 키가 필요합니다.

Open WebUI 설치

플랫폼에 맞는 공식 Open WebUI 빠른 시작을 따르세요. 로컬 Docker 설치의 경우 공식 이미지를 다음 명령으로 시작할 수 있습니다:

SHELL 
docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main

애플리케이션을 열고 관리자 계정을 생성한 후, 연결을 추가하기 전에 로그인하십시오.

RunAPI 연결 추가

  1. 관리자 설정 → 연결 → OpenAI를 열고 연결 추가를 선택합니다.
  2. URL을 https://runapi.ai/v1으로 설정하고 RunAPI API 키를 입력합니다.
  3. 첫 번째 연결 시도 시 Open WebUI가 사용 가능한 모델을 자동으로 검색할 수 있도록 모델 ID(필터)를 비워 둡니다.
  4. 연결을 저장하고 인증이 완료될 때까지 기다립니다.

Open WebUI는 백엔드에서 연결 확인을 전송하며 검색에 GET /v1/models를 사용합니다. RunAPI URL은 공개 HTTPS이므로 Docker 설치 환경에서 이 연결에 host.docker.internal이 필요하지 않습니다.

모델 선택

새 채팅을 열고 채팅 모델 선택기에서 RunAPI 모델을 선택하십시오. 현재 모델 식별자와 기능을 확인하려면 모델 카탈로그를 참조하십시오.

검색이 선택기를 채우지 않으면 연결을 편집하고 Model IDs (Filter) 아래에 정확한 식별자를 추가하세요. 모델 검색 오류와 Chat Completions 오류는 별개의 신호입니다. 연결을 제거하기 전에 수동으로 추가한 모델을 테스트하세요.

연결 확인

Reply with the word connected.와 같은 짧은 프롬프트를 전송하세요. 정상적인 스트리밍 또는 완전한 응답은 Open WebUI가 선택한 RunAPI 모델을 사용할 수 있음을 확인합니다.

문제 해결

  • 인증 확인에서 401 또는 403 반환: 연결의 API 키를 인증 가이드에서 발급한 유효한 표준 키로 교체하세요.
  • RunAPI 모델이 표시되지 않음: URL이 /v1로 끝나는지 확인한 후 현재 식별자 하나를 Model IDs (Filter)에 추가하고 채팅을 다시 시도하세요.
  • 모델은 표시되지만 채팅 실패: Model Catalog에서 해당 식별자가 OpenAI 호환 Chat Completions을 지원하는지 확인한 후 Open WebUI 백엔드 로그에서 요청 상태를 검사하세요.
  • 로컬 URL이 브라우저에서는 작동하지만 Open WebUI에서는 작동하지 않음: Open WebUI 연결은 백엔드에서 시작됩니다. 이는 공개 https://runapi.ai/v1 URL에는 영향을 주지 않지만 다른 로컬 연결에서는 문제가 될 수 있습니다.

공유 프로토콜 동작에 대해서는 LLM API 빠른 시작을 참조하세요. 요청 및 응답 필드에 대해서는 Chat Completions API 참조를 참조하세요.