Open WebUI

Admin Settings의 OpenAI 연결 하나 또는 컨테이너 시작 시 OPENAI_API_BASE_URL과 OPENAI_API_KEY — 모두 동일한 /v1에서 끝납니다

# Settings → Admin Settings → Connections → Manage OpenAI API Connections → +
URL                https://api.kunavo.com/v1
API Key            sk-kn-...
Model IDs (Filter) claude-sonnet-5, claude-opus-5, claude-haiku-4-5, gpt-5-6-terra

# …or at container start, same thing:
docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.kunavo.com/v1 \
  -e OPENAI_API_KEY=sk-kn-... \
  -v open-webui:/app/backend/data \
  --name open-webui ghcr.io/open-webui/open-webui:main

단계별 안내

1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
2. Open WebUI에서 설정 → 관리자 → 연결로 이동한 다음 OpenAI API 연결 관리를 찾으세요.
3. ➕ 연결 추가를 클릭하고 URL과 API 키를 입력하세요.
4. 원하는 ID를 Model IDs (Filter)에 추가한 다음 저장하고 연결 검증을 진행하세요.
5. 새 채팅을 시작하세요. 모델 선택기에 연결 이름이 앞에 붙은 모델이 표시됩니다.

Open WebUI의 OpenAI 호환 공급자 안내에서 확인했습니다(2026년 9월 6일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Open WebUI에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.