OpenWebUI에 API가 있나요? 네, 두 가지 방향이 있습니다

사람들이 의미하는 두 가지 다른 API

누군가가 Open WebUI에 API가 있는지 묻는다면, 두 가지 방향 중 하나를 묻는 것일 수 있습니다. 이 둘을 혼동하면 설정 가이드가 복잡하게 느껴지는 주된 이유이므로, 먼저 구분하는 것이 도움이 됩니다.

• 수신: 프로그램이 Open WebUI로 요청을 보냅니다. 채팅, 모델, 파일용 엔드포인트를 가지며, 앱 내에서 생성한 API 키로 보호됩니다.
• 송신: Open WebUI가 모델 서버로 요청을 보내 채팅 창이 응답할 수 있게 합니다. 이 연결은 관리자 설정에서 구성합니다.

따라서 짧은 답변은 둘 다 그렇습니다. 이 프로젝트는 OpenAI 스타일의 채팅 엔드포인트를 가진 API를 문서화하며, OpenAI 프로토콜을 사용하는 모든 서버와의 연결을 지원합니다. 정확한 경로와 키 처리 방식은 버전마다 달라질 수 있으므로 실행 중인 버전의 문서를 확인하세요.

이 사이트는 송신 측에서 모델을 제공합니다. 단일 모델 ID가 uncensored인 호스팅된 OpenAI 호환 텍스트 API입니다. 이 사이트는 Open WebUI가 아니며, Open WebUI를 대신 실행하지도 않습니다. Open WebUI는 사용자가 직접 호스팅하는 소프트웨어입니다.

Open WebUI의 자체 API 사용

Open WebUI는 로그인한 사용자가 계정 설정에서 API 키를 생성할 수 있습니다. 이 키를 사용하면 스크립트에서 엔드포인트를 호출할 수 있습니다. 채팅 엔드포인트는 OpenAI 형식을 따르므로 기존 클라이언트 코드를 이 엔드포인트로 연결할 수 있는 경우가 많습니다. 작성 시점의 프로젝트 문서에 따르면 경로는 /api/chat/completions입니다. 버전별로 확인하세요.

Copy# Open WebUI running locally on port 3000, key created in Settings > Account
curl http://localhost:3000/api/chat/completions \
  -H "Authorization: Bearer $OPENWEBUI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Summarize this scene in one line."}]}'

참고로 여기서 모델 이름은 Open WebUI에 등록된 모델입니다. 이 API를 백엔드로 연결한 경우 해당 이름은 uncensored입니다. 이 요청의 키는 Open WebUI 키이며 모델 API 키가 아닙니다. 이 둘은 서로 다른 자격 증명으로 서로 다른 역할을 합니다.

수신 API를 사용해야 하는 이유는 무엇인가요? 저장된 지식 컬렉션, 사용자별 계정 또는 모델 프리셋 등 Open WebUI의 추가 기능을 프로그램 뒤에서 사용하고 브라우저 없이 접근하고 싶을 때 유용합니다.

백엔드로 외부 API 사용

다른 방향은 대부분의 사람이 필요로 하는 것입니다. Open WebUI에는 OpenAI 호환 연결을 위한 섹션이 있으며, URL과 키를 입력합니다. 이 서비스의 값은 다음과 같습니다.

• URL: https://api.nsfwvideo.top/v1
• 키: 키 페이지에서 얻은 키
• 모델: uncensored, GET /v1/models를 통해 자동으로 발견됩니다.

단계별: 관리자 설정을 열고 연결로 이동한 후, OpenAI API 연결을 추가하고 URL과 키를 붙여넣은 후 저장합니다. 새 채팅에서 모델을 선택하세요. 명령줄 시작을 선호한다면 컨테이너 실행 시 환경 변수 OPENAI_API_BASE_URL과 OPENAI_API_KEY을 설정하세요.

Copydocker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.nsfwvideo.top/v1 \
  -e OPENAI_API_KEY=$API_KEY \
  -v open-webui:/app/backend/data \
  ghcr.io/open-webui/open-webui:main

Open WebUI는 첫 시작 시 많은 설정을 데이터베이스에 저장한다는 점에 유의하세요. 나중에 환경 변수를 변경해도 변경 사항이 적용되지 않으면 관리 패널에서 연결을 편집하세요. 백엔드가 기대하는 요청 형식은 빠른 시작 가이드에 나와 있습니다. curl로 확인하려면 해당 형식을 참조하세요.

두 API 연결

두 방향을 동시에 사용할 수 있습니다. 애플리케이션이 Open WebUI 키로 Open WebUI의 수신 API를 호출하면, Open WebUI는 구성한 백엔드로 채팅을 전달하고 응답이 다시 돌아옵니다. 이 구성은 몇 가지 상황에서 유용합니다: 팀이 이미 계정과 함께 Open WebUI를 운영하며 스크립트가 그 프리셋을 공유하기를 원하거나, 사람과 프로그램 모두를 위한 페르소나 설정을 한 곳에 보관하고 싶은 경우입니다.

추가 홉이 생깁니다. 모든 요청은 이제 모델 API에 도달하기 전에 Open WebUI 서버를 통과하므로, 유지 관리, 패치 및 보안 처리해야 할 항목이 하나 더 생깁니다. 속도 제한도 예상치 못한 방식으로 중첩됩니다. 백엔드 키는 전체 키당 동시 8개 요청과 분당 300개를 허용하며, Open WebUI 인스턴스를 거치는 모든 사용자와 스크립트가 이 할당량을 공유합니다. 백엔드가 HTTP 429, 오류 코드 rate_limited 또는 concurrency로 응답하면 실패는 보통 Open WebUI와 호출자 측에서 오류로 나타납니다.

Open WebUI를 건너뛰고 API 직접 호출이 필요한 경우

개요, 촬영 설명 또는 초안 내레이션 생성 등 텍스트를 생성하는 스크립트만 필요하다면 Open WebUI는 불필요합니다. 이 서비스는 일반 OpenAI 호환 엔드포인트이므로 표준 SDK가 직접 통신합니다.

Copyimport os
from openai import OpenAI

client = OpenAI(base_url="https://api.nsfwvideo.top/v1", api_key=os.environ["API_KEY"])

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You write concise shot lists for short films."},
        {"role": "user", "content": "Shot list for a ninety second chase through a night market."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)

직접 호출하면 SSE 스트리밍, 함수 호출, JSON 모드, 모든 샘플링 파라미터를 미들웨어 레이어 없이 사용할 수 있습니다. Open WebUI는 기록, 계정, 프리셋이 포함된 채팅 인터페이스가 필요할 때 더 나은 선택입니다. 배치 작업에는 스크립트가 더 적합합니다. API는 텍스트만 생성합니다. 비디오, 이미지, 오디오를 렌더링하지 않으므로 비디오 프로젝트에는 스크립트와 다른 도구를 위한 프롬프트를 제공합니다. 비디오 파이프라인 페이지에서 해당 사용 사례를 자세히 알아보세요.

빠른 결정 가이드

• 자신이나 팀을 위한 채팅 창이 필요할 경우: Open WebUI를 실행하고 아웃바운드 연결을 추가하세요.
• 스크립트가 Open WebUI 프리셋이나 계정을 재사용하기를 원함: Open WebUI 키로 수신 API를 사용하세요.
• 배치 텍스트 생성이 필요함: OpenAI SDK를 사용하여 모델 API를 직접 호출하고 추가 계층을 건너뛰세요.
• 이미지나 음성이 필요함: Open WebUI나 이 텍스트 API만으로는 이를 생성할 수 없습니다. 해당 단계에 별도 도구를 연결하세요.

어떤 경로를 선택하든 모델의 사실 관계는 동일합니다: 프롬프트와 응답이 공유하는 100,000토큰 컨텍스트 창, 사용 가능한 함수 호출 및 JSON 모드, 그리고 미성년자가 관련된 성적 콘텐츠에 대한 엄격한 금지 규칙이 있습니다.

API 노출을 위한 보안 참고 사항

두 키 모두 비밀로 취급하십시오. Open WebUI 키는 인스턴스 내에서 키를 생성한 사용자가 수행할 수 있는 모든 작업을 허용합니다. 모델 API 키는 선불 잔액을 사용합니다. 둘 다 클라이언트 측 코드나 공개 저장소에 붙여넣지 마십시오.

• Open WebUI가 자체 머신 외부에서 접근 가능한 경우 HTTPS 뒤에 두세요.
• 스크립트별로 별도의 Open WebUI 키를 생성하여 하나를 무효화해도 다른 것이 중단되지 않도록 하세요.
• 모델 API 키가 로그나 스크린샷에 표시된 적이 있다면 키를 갱신하십시오.
• 호출당 지출액을 확인하려면 백엔드에서 X-Balance-USD 응답 헤더를 확인하세요.

프라이버시 측면에서 이 API로 전송된 프롬프트는 학습에 사용되지 않습니다. Open WebUI 자체는 서버의 자체 데이터베이스에 채팅 기록을 저장하므로, 호스팅 선택이 해당 데이터를 누가 읽을 수 있는지 결정합니다.

이 설정을 실행하는 데 드는 비용

Open WebUI는 호스팅하는 무료 소프트웨어입니다. 비용은 서버 비용과 토큰 비용입니다. 토큰은 선불 크레딧에서 청구되며 구독은 없습니다. 입력 토큰 1M당 $0.15, 출력 토큰 1M당 $0.50으로 청구됩니다. 입력 토큰 3,000과 출력 토큰 500으로 대화 턴을 진행하면: 입력은 3,000 x $0.15 / 1M = $0.00045, 출력은 500 x $0.50 / 1M = $0.00025로 총 $0.0007이 됩니다. 이러한 턴 1,000개는 $0.70이 듭니다.

충전 금액은 $20부터 $500까지의 정수 금액이며, $50 이상 충전 시 +5%, $100 이상 충전 시 +10%, $200 이상 충전 시 +15%의 보너스가 제공됩니다. 결제는 암호화폐로, TRC20 네트워크의 USDT 또는 Base 네트워크의 USDC로 가능합니다. 실패하거나 거부된 요청은 청구되지 않으며, 크레딧은 만료되지 않습니다. 새 사용자는 결제 정보 없이 한 번의 클릭으로 7일 동안 $0.50 무료 체험 크레딧을 청구할 수 있습니다. 전체 내용은 가격 페이지에서 확인하십시오.

콘텐츠 관련 안내: 이 모델은 합법적인 성인용 사용에 대해 콘텐츠 거부 없이 답변하도록 조정되었으며, 미성년자가 포함된 성 콘텐츠는 절대 허용되지 않습니다.

더 많은 가이드

• NSFW 비디오 파이프라인용 무검열 LLM API