5분 만에 Open WebUI OpenAI 호환 API 설정하기
open webui openai compatible api 설정을 사용하려면 베이스 URL과 키가 있는 연결을 하나 추가하면 모델이 선택기에 나타납니다. Docker부터 첫 번째 채팅까지 Abliterated API에 대한 정확한 설정은 다음과 같습니다.
업데이트됨

주요 포인트
- 베이스 URL은 https://api.abliteratedapi.com/v1이며 모델 ID는
uncensored입니다. - 관리자 연결 설정에 추가하거나 Docker에 OPENAI_API_BASE_URL과 OPENAI_API_KEY를 전달하세요.
- 먼저 curl로 키를 테스트하여 키 문제인지 UI 문제인지 구분하세요.
- Open WebUI는 프론트 엔드일 뿐입니다. 모델이 읽고 쓰는 토큰에 대해 토큰당 요금을 지불하며, 시작하기 위해 카드가 필요하지 않습니다.
간단 요약
Open WebUI용 OpenAI 호환 API 설정을 한 단락으로 요약하면 다음과 같습니다: 관리자 설정을 열고 OpenAI API 연결을 추가한 후, URL을 https://api.abliteratedapi.com/v1로 설정하고 키를 붙여넣은 후 저장합니다. 그런 다음 uncensored 모델을 선택하면 됩니다. 이게 전부입니다. Open WebUI는 OpenAI 채팅 완료 형식을 구현하는 모든 서비스에 연결하며, 이 API도 이를 지원합니다.
이 서비스는 합법적인 성인 사용을 위해 콘텐츠 거부 없이 답변하도록 조정된 단일 오픈 웨이트 모델을 실행하는 호스팅된 OpenAI 호환 텍스트 API입니다. 독립적인 제공업체에서 운영하며 어떤 모델 연구소의 공식 API가 아닙니다. Open WebUI는 이를 가리키는 채팅 프론트 엔드일 뿐입니다.
시작하기 전
- API 키. API 키 페이지에서 생성하세요. Google 또는 이메일과 비밀번호로 로그인할 수 있습니다. 신규 사용자는 해당 페이지에서 클릭 한 번으로 7일 유효한 무료 체험 크레딧 $0.50을 받을 수 있으며 카드가 필요하지 않습니다.
- 실행 중인 Open WebUI. Docker 설치나 pip 설치가 모두 작동합니다. 아래 단계는 Docker와 설정 화면을 다룹니다.
- 네트워크 접근: Open WebUI를 실행 중인 머신에서
api.abliteratedapi.com로 HTTPS를 통해 연결할 수 있어야 합니다.
UI를 건드리기 전에 키를 확인하세요. 이 호출이 uncensored를 포함하는 목록을 반환하면 키와 URL이 올바릅니다:
curl https://api.abliteratedapi.com/v1/models -H "Authorization: Bearer $ABLITERATED_API_KEY"
그런 다음 실제 응답이 생성되는지 확인합니다:
curl https://api.abliteratedapi.com/v1/chat/completions -H "Authorization: Bearer $ABLITERATED_API_KEY" -H "Content-Type: application/json" -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'방법 1: 설정에서 연결 추가
가장 쉬운 방법이며 기존 설치에서도 작동합니다. 메뉴 레이블은 Open WebUI 버전마다 이동하므로 아래 이름이 약간 다를 수 있습니다.
- Open WebUI에 관리자로 로그인한 후 관리자 패널, 설정, 연결을 엽니다.
- OpenAI API 섹션을 찾아 플러스 버튼을 사용하여 새 연결을 추가하세요.
- URL 필드에
https://api.abliteratedapi.com/v1을 입력하세요./v1에서 멈추세요./chat/completions을 추가하지 마세요. Open WebUI가 경로를 자체적으로 추가합니다. - 키 필드에 키를 붙여넣으세요.
Authorization: Bearer <key>로 전송됩니다. - 버전이 확인 버튼을 지원한다면 필드 옆의 확인 버튼을 사용하고 저장하세요.
새 채팅을 열고 모델 선택기를 엽니다. Open WebUI는 GET /v1/models에서 모델을 읽으므로 모델 uncensored이 목록에 있어야 합니다. 목록이 비어 있는 경우 아래 문제 해결 섹션으로 이동하세요.
방법 2: 시작 시 Docker로 설정
새로운 설치의 경우 엔드포인트를 환경 변수로 전달하세요. Open WebUI는 시작 시 OPENAI_API_BASE_URL과 OPENAI_API_KEY을 읽습니다.
# base URL: https://api.abliteratedapi.com/v1 model to pick in the UI: uncensored
docker run -d -p 3000:8080 -e OPENAI_API_BASE_URL="https://api.abliteratedapi.com/v1" -e OPENAI_API_KEY="$ABLITERATED_API_KEY" -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
그런 다음 http://localhost:3000를 방문하고 첫 번째 계정을 생성(관리자가 됨)한 후 채팅을 시작하세요. 이름이 지정된 볼륨은 컨테이너를 업데이트할 때 채팅과 설정을 유지합니다.
많은 사용자가 실수하는 부분이 있습니다. Open WebUI의 많은 설정은 첫 실행 후 데이터베이스에 저장되며, 나중에 설정된 환경 변수보다 저장된 값이 우선 적용될 수 있습니다. Docker에서 키나 URL을 변경했는데도 적용되지 않는다면, 연결 화면에서 변경하거나 저장된 설정을 초기화하세요.
조정할 만한 설정
채팅이 작동하면 몇 가지 옵션이 경험을 향상시키고 청구서를 예측 가능하게 유지합니다.
컨텍스트 창을 현명하게 사용하세요
컨텍스트 창은 프롬프트와 응답을 합쳐 100,000개의 토큰을 지원합니다. Open WebUI는 메시지마다 대화 기록을 다시 보내므로, 긴 대화일수록 턴이 지날수록 비용이 더 많이 듭니다. 입력 토큰 100만 개당 $0.15의 요금이 부과되며, 20,000개의 토큰으로 구성된 기록 전송 비용은 $0.003입니다. 저렴하지만 수천 번의 메시지가 쌓이면 비용이 누적됩니다. 새로운 주제라면 새 채팅을 시작하세요.
스트리밍 및 샘플링
Open WebUI는 기본적으로 응답을 스트리밍하며, API는 SSE를 통한 스트리밍을 지원합니다. 고급 매개변수에서 temperature, top_p, 종료 시퀀스, 반복 가능한 출력을 위한 시드 및 페널티를 설정할 수 있습니다. 이 값들은 모델에 전달됩니다. 선택 사항이므로 max_tokens은 제한을 두고 싶지 않다면 비워두세요.
백그라운드 작업
Open WebUI는 채팅 이름 지정과 같은 작업을 위해 백그라운드에서 추가 모델 호출을 수행할 수 있습니다. 각 호출은 잔액에서 실제 요청으로 처리되며 속도 제한에 포함됩니다. 사용자가 입력하지 않은 호출이 발생한다면 작업 모델 설정을 확인하고 비용 지불에 동의하는 모델로 연결하거나, 헬퍼 기능을 비활성화하세요.
프리셋 및 시스템 프롬프트
Open WebUI는 작업 공간 섹션에 모델 프리셋을 저장할 수 있습니다: 이름, 기본 모델, 시스템 프롬프트 및 기본 매개변수. 편집 어시스턴트, 코드 검토자 또는 인터랙티브 픽션 세션을 위한 캐릭터와 같이 자주 수행하는 각 작업에 대해 uncensored 위에 하나씩 만드세요. 역할, 어조 및 응답 형식을 명시하는 짧은 시스템 프롬프트는 모든 채팅에 붙여넣는 긴 지침보다 더 효과적입니다.
이 부분에서 모델의 프로필이 도움이 됩니다. 이 모델은 합법적인 성인 사용 목적의 콘텐츠 거부 없이 답변하도록 튜닝된 오픈 웨이트 모델입니다. 장면 중간에 거부가 발생하면 흐름이 끊기는 소설, 역할극, 성인용 컴패니언 앱에 적합합니다. 하지만 하드 제한은 변하지 않습니다: 미성년자가 포함된 성적 콘텐츠는 절대 없습니다. 프리셋과 공유 인스턴스를 해당 규칙과 거주 지역의 법률 내에서 유지하세요.
다른 사람들이 귀하의 Open WebUI 인스턴스를 사용하는 경우, 모두 귀하의 키와 제한을 공유한다는 점을 기억하세요. 전체 키는 8개의 동시 요청을 허용하므로 소수의 활성 사용자는 괜찮지만, 한 번에 채팅하는 대규모 그룹은 제한에 도달할 수 있습니다. 각 사람이나 팀에 고유한 키를 제공하면 부하가 분산되고 잔액 추적이 쉬워집니다.
실행 비용
선불 크레딧에서 토큰에만 지불합니다: 입력 토큰 1M당 $0.15, 출력 토큰 1M당 $0.50. 실패하거나 거부된 요청은 요금이 부과되지 않으며 크레딧은 만료되지 않습니다. 3,000 토큰의 기록과 400 토큰의 응답이 있는 일반적인 채팅 메시지 비용은 $0.00045 + $0.0002 = $0.00065이므로 $10의 사용량은 약 15,000개의 메시지에 해당합니다.
충전은 $20부터 $500까지 어떤 정수 금액으로 가능하며, $50부터 +5%, $100부터 +10%, $200부터 +15%의 보너스가 제공됩니다. 암호화폐(TRC20의 USDT, Base의 USDC)로 결제할 수 있습니다. 자세한 내용은 가격 책정 페이지를 참조하세요. 스크립트에서 모니터링하려면 각 API 응답의 X-Balance-USD 헤더에 잔액이 반환됩니다.
문제 해결
| 증상 | 잠재적 원인 | 해결 방법 |
|---|---|---|
| 모델 목록이 비어 있음 | 잘못된 URL 또는 키 | /v1/models에 대한 curl 테스트를 실행하세요. URL은 /v1로 끝나야 합니다. |
| Docker에서 연결 거부 또는 시간 초과 | 컨테이너에서 외부 HTTPS 없음 | 호스트의 DNS, 프록시 및 방화벽 설정을 확인하세요. |
| 모든 메시지에서 인증 오류 | 공백이 포함된 키 또는 오래된 키 | 키 페이지에서 키를 다시 복사하여 저장하세요. |
| 여러 사람이 동시에 채팅할 때 오류 발생 | 속도 제한 | 전체 키는 분당 300회, 동시 8개 요청을 허용합니다. 체험 키는 분당 60회, 동시 2개 요청을 허용합니다. |
| 긴 채팅이 작동하지 않음 | 컨텍스트 창이 가득 참 | 창의 용량은 100,000 토큰입니다. 새 채팅을 시작하거나 요약하세요. |
curl 테스트는 통과하지만 Open WebUI가 실패한다면 문제는 프론트엔드 설정에 있습니다. curl이 실패한다면 먼저 키와 잔액을 확인하세요. 문서의 빠른 시작 가이드에는 모든 요청 매개변수가 나열되어 있으며, 무검열 채팅 API란 무엇이며 어떤 것이 아닌지 기사에서는 모델의 범위를 설명하며, 미성년자가 포함된 성적 콘텐츠는 금지라는 하드 제한도 포함합니다.
더 많은 가이드
질문과 답변
Open WebUI에 어떤 URL을 입력해야 하나요?
https://api.abliteratedapi.com/v1만 입력하세요. Open WebUI는 /chat/completions 및 /models를 자동으로 추가합니다.
어떤 모델 이름을 선택해야 하나요?
모델 ID는 uncensored입니다. 연결이 저장되고 모델 목록이 로드되면 모델 선택기에서 확인할 수 있습니다.
시도해 보려면 카드가 필요한가요?
아니요. 신규 사용자는 API 키 페이지에서 클릭 한 번으로 $0.50의 무료 체험 크레딧을 받을 수 있습니다. 이 크레딧은 7일 동안 유효하며 카드가 필요하지 않습니다.
로컬 모델과 함께 실행할 수 있나요?
네. Open WebUI는 여러 연결을 동시에 지원하므로 이 엔드포인트는 로컬 모델 옆에 배치할 수 있으며, 모두 동일한 모델 선택기에 표시됩니다.
내 채팅이 학습에 사용되나요?
아니요. API로 전송된 프롬프트는 학습에 사용되지 않습니다. Open WebUI에 저장된 채팅 기록은 사용자 자신의 설치 환경에 남아 있습니다.