코드 없는 채팅봇 튜토리얼: Open WebUI 및 기타
이 코드 없는 채팅봇 튜토리얼은 앱을 작성하지 않고도 OpenAI 호환 무검열 API에서 작동하는 채팅 인터페이스를 제공합니다. 채팅 창이 이미 있는 도구에 Base URL과 키를 붙여넣기만 하면 됩니다.
업데이트

주요 포인트
- 사용자 정의 OpenAI 호환 엔드포인트를 허용하는 모든 채팅 프론트 엔드는 이 API를 사용할 수 있습니다.
- 베이스 URL, 키 및 모델 ID uncensored 세 가지 값이 필요합니다.
- Open WebUI와 SillyTavern은 커스텀 엔드포인트를 지원하는 도구이며, 약간의 코드를 원하신다면 LangChain으로 업그레이드할 수 있습니다.
- 무료 체험으로 시작하고, 암호화폐로 $20부터 충전하세요.
여기서 '코드 없이'의 의미
이 모델과 대화하기 위해 채팅 인터페이스를 직접 빌드할 필요가 없습니다. OpenAI 채팅 형식을 지원하는 모든 서버에 연결하기 위해 작성된 여러 오픈 소스 채팅 프론트 엔드가 있으며, 이 API도 이를 지원합니다. 따라서 코드 없는 채팅봇 튜토리얼은 하나의 아이디어로 요약됩니다: 완성된 채팅 앱을 설치하고 사용자 정의 엔드포인트를 가리킨 후 채팅하는 것입니다.
이 접근 방식의 한계를 명확히 하세요. 이러한 도구는 개인 또는 팀용 채팅 창을 제공합니다. 웹 페이지에 삽입할 수 있는 위젯이 아닌 독립형 앱입니다. 자신의 사이트에 봇을 원한다면 백엔드가 필요하며, 웹 채팅 튜토리얼에서 이를 다룹니다. 아래 내용은 프로그래밍 없이 채팅하고, 페르소나를 테스트하거나 프로토타입을 만들고자 하는 사람들을 위한 것입니다.
시작하기 전에 필요한 항목
세 가지 값을 수집하세요.
- Base URL:
https://api.uncensoredchatbotapi.com/v1 - API 키: API 키 페이지에서 발급받으세요. Google 또는 이메일과 비밀번호로 가입한 후 한 번의 클릭으로 체험을 청구하세요. 이는 $0.50의 크레딧을 제공하며, 7일 동안 유효하고, 사람당 하나이며, 결제가 필요하지 않습니다.
- 모델 ID:
uncensored
인증은 표준 Bearer token을 사용하며, 모든 OpenAI 호환 도구는 이를 이미 처리합니다. 엔드포인트는 채팅용 POST /v1/chat/completions, 모델 목록용 GET /v1/models입니다. 도구는 일반적으로 두 번째 엔드포인트를 호출하여 모델 드롭다운을 채우므로, 목록이 비어 있다면 베이스 URL이 원인일 가능성이 높습니다.
터미널에서 간단한 검증을 수행하면 시간을 절약할 수 있습니다:
curl https://api.uncensoredchatbotapi.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"모델 목록이 출력되면 연결하는 모든 도구는 동일한 값으로 작동합니다.
옵션 1: Open WebUI
Open WebUI는 OpenAI 호환 연결을 지원하는 자체 호스팅 채팅 인터페이스입니다. Docker가 설치되어 있다면 다음 명령어로 엔드포인트가 사전 구성된 상태로 시작할 수 있습니다:
docker run -d -p 3000:8080 \
-e OPENAI_API_BASE_URL=https://api.uncensoredchatbotapi.com/v1 \
-e OPENAI_API_KEY=YOUR_KEY \
-v open-webui:/app/backend/data \
--name open-webui \
ghcr.io/open-webui/open-webui:mainOpen http://localhost:3000, 로컬 관리자 계정을 생성하고 모델 드롭다운에서 uncensored을 선택하세요. 인터페이스에서 구성하려면 관리자 설정으로 이동하여 연결 섹션을 열고 OpenAI 연결을 추가한 후 Base URL과 키를 붙여넣으세요. 메뉴 이름은 버전마다 다를 수 있으므로 라벨이 다르면 프로젝트의 자체 문서를 확인하세요.
채팅 또는 저장된 모델 프리셋마다 시스템 프롬프트를 설정하여 페르소나 또는 하우스 룰이 매번 적용되도록 하세요. 시스템 프롬프트는 각 메시지마다 다시 전송되므로 입력 토큰으로 청구되므로 짧게 유지하세요.
옵션 2: 캐릭터 및 로플레이를 위한 SillyTavern
SillyTavern은 캐릭터 채팅용으로 구축된 로컬 프론트 엔드로, 캐릭터 프로필, 로어북 및 그룹 채팅을 지원합니다. OpenAI 호환 엔드포인트를 추가할 수 있어 성인의 픽션 및 동반자 스타일 사용에 적합합니다.
- SillyTavern의 자체 지침에 따라 설치하고 시작하세요.
- API 연결 패널을 열고 채팅 완료 유형을 선택하세요.
- 사용자 정의 OpenAI 호환 소스를 선택하세요.
- 엔드포인트로
https://api.uncensoredchatbotapi.com/v1를 붙여넣고 API 키로 키를 입력하세요. - 모델 ID로
uncensored를 입력한 후 연결을 누르세요.
상태가 녹색으로 바뀌면 캐릭터를 불러오거나 생성한 후 메시지를 보내세요. 100,000토큰 컨텍스트 창은 긴 캐릭터 시트와 lorebook을 수용할 수 있지만, 더 큰 프롬프트는 매 턴마다 비용이 더 듭니다. 일관된 캐릭터 작성을 위한 아이디어는 캐릭터 및 페르소나 디자인 가이드를 참조하세요. 스토리는 합법적인 성인 용도로만 사용하세요. 미성년자가 관련된 성적 콘텐츠는 절대 허용되지 않습니다.
옵션 3: 5줄의 LangChain
짧은 Python 스크립트를 실행할 수 있다면 LangChain은 나중에 템플릿, 메모리 및 에이전트로 연결할 수 있는 브릿지를 제공합니다. 이는 노코드보다는 저코드에 해당하지만 거의 노력이 들지 않습니다:
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
model="uncensored",
base_url="https://api.uncensoredchatbotapi.com/v1",
api_key="YOUR_KEY",
)
print(llm.invoke("Introduce yourself as a friendly guide in one sentence.").content)pip install langchain-openai로 설치하세요. 여기에서 프롬프트 템플릿을 추가하거나 토큰을 스트리밍하거나 도구를 바인딩할 수 있습니다. API는 함수 호출과 JSON 모드를 모두 지원하므로 에이전트 스타일의 체인이 작동합니다. temperature, top_p, stop, seed와 같은 매개변수는 전달되므로 원본 OpenAI 패키지와 동일한 방식으로 창의성을 조정할 수 있습니다.
코드 없이 시스템 프롬프트 작성하기
시스템 프롬프트는 코드 없는 설정의 품질을 결정하는 곳입니다. 위의 모든 도구에는 이를 위한 상자가 있으며, 내용은 모두 동일하게 작동합니다. 네 가지 짧은 부분으로 구성하세요: 역할, 목소리, 형식 및 경계.
역할 행은 봇의 정체성을 나타내며, 예를 들어 소규모 에이전시의 여행 플래너나 미스터리 게임의 내레이터가 될 수 있습니다. 음성 행은 따뜻하고 간결하거나 건조하고 격식 있는 등 어조를 설정합니다. 형식 행은 세 개의 짧은 단락이나 불릿 포인트 계획처럼 응답의 길이와 형태를 고정합니다. 경계 행은 봇이 거부하거나 전환해야 할 내용을 명시하며, 이는 모든 공개 사용 사례에서 중요합니다. 전체 내용은 200단어 이내로 유지하세요. 긴 프롬프트는 매 메시지마다 입력 토큰을 더 많이 소모하며, 종종 응답의 일관성을 떨어뜨립니다.
한 번에 하나의 요소만 변경하고 동일한 세 가지 테스트 메시지를 다시 실행하세요. 역할과 형식을 함께 편집하면 어떤 변경이 도움이 되었는지 알 수 없습니다. 각 버전을 텍스트 파일로 저장하는 데는 몇 분 정도 걸리며, 나중에 추측하는 노력을 덜어줍니다.
성인 픽션 및 동반자 사용의 경우, 프롬프트 및 관련 로그인 절차에 연령 기대치를 설정하세요. 이 모델은 합법적인 성인 사용을 위해 조정되었으며, 유일한 고정 규칙은 미성년자가 관련된 성적 콘텐츠가 절대 허용되지 않는다는 것입니다.
어떤 옵션을 선택해야 할까요?
자신이나 소규모 팀을 위한 범용 채팅 창을 원한다면 Open WebUI를 선택하세요. 익숙한 레이아웃을 제공하며 로컬로 기록을 유지하고 한 번의 명령어로 시작할 수 있습니다. 로어북과 함께 긴 캐릭터 중심 스토리나 로플레이를 원한다면 SillyTavern을 선택하세요. 프로토타입을 나중에 앱으로 전환할 계획이라면 LangChain 스니펫으로 시작하세요. 같은 몇 줄이 실제 프로젝트로 확장될 수 있습니다.
이러한 도구 중 어느 것도 이 서비스에서 유료 플랜이 필요하지 않습니다. 체험이 만료될 때만 선불 크레딧을 충전하고, 사용한 토큰에 대해서만 지불합니다. 하나의 도구를 시도하고 마음에 들지 않으면 Base URL, 키 및 모델 ID가 모든 곳에서 동일하므로 계정을 변경하지 않고 다른 도구로 전환할 수 있습니다.
비용, 제한 및 일반적인 문제
선불 크레딧에서 1M 입력 토큰당 $0.15, 1M 출력 토큰당 $0.50을 지불하며 구독은 없습니다. 20개의 메시지로 구성된 캐주얼 채팅 세션은 메시지당 평균 1,000 입력 토큰과 250 출력 토큰을 사용하므로 총 20,000 입력 토큰과 5,000 출력 토큰이 필요합니다. 이는 $0.003 + $0.0025 = $0.0055가 들며, 이 비율로 $0.50 체험 크레딧으로 약 90개의 세션을 커버할 수 있습니다. 실패하거나 거부된 요청은 요금이 부과되지 않습니다.
체험 크레딧이 부족해지면 $20부터 $500까지 충전할 수 있으며, $50부터는 +5%, $100부터는 +10%, $200부터는 +15%의 보너스를 TRC20의 USDT 또는 Base의 USDC로 지불하여 받습니다. 크레딧은 만료되지 않습니다. 가격 책정 페이지에서 전체 세부 정보를 확인할 수 있습니다.
무언가 실패한 경우
- 빈 모델 목록 또는 연결 오류: URL이
/v1로 끝나고 추가 경로가 없으며, 키에 불필요한 공백이 없는지 확인하세요. - 401: 키가 잘못되었거나 누락되었습니다.
- 429 with code
concurrency: 체험 키는 동시 요청 2개와 분당 60개를 허용합니다. 스트리밍된 요청은 끝날 때까지 슬롯을 유지하므로 추가 탭을 닫거나 스트리밍이 완료될 때까지 기다리세요. - 429 (코드
rate_limited): 분당 속도 제한에 도달했습니다. 1분 기다리세요. 전체 키는 최대 8개의 동시 요청과 분당 300개의 요청을 허용합니다. - 429 with
Retry-After: 5: 일시적인 과부하입니다. 5초 후 다시 시도하세요.
체험 자체에 대한 질문은 무료 체험 FAQ에서 답변하며, API 문서에는 전체 매개변수 세트가 나열되어 있습니다. 이 서비스는 텍스트 전용이므로, 이미지 생성, 음성 및 임베딩은 이 엔드포인트를 통해 이러한 도구에서 사용할 수 없습니다.
더 많은 가이드
질문과 답변
코딩을 알아야 하나요?
Open WebUI나 SillyTavern과 같은 완성된 채팅 도구를 사용한다면 필요 없습니다. 연결 설정에 Base URL, API 키, 모델 ID uncensored를 입력하면 됩니다.
이러한 도구 중 하나를 제 공개 웹사이트에 둘 수 있나요?
이들은 임베드 가능한 위젯이 아닌 독립형 채팅 앱입니다. 공개 사이트에 사용하려면 web chat 튜토리얼에 표시된 대로 API 키를 비공개로 유지하는 작은 백엔드가 필요합니다.
어떤 모델 ID를 입력해야 하나요?
uncensored를 입력하세요. 키를 사용하여 GET /v1/models를 호출하여 확인할 수 있습니다.
무료로 사용해 볼 수 있나요?
신규 사용자는 API 키 페이지에서 한 번의 클릭으로 7일 동안 유효한 $0.50의 무료 체험 크레딧을 받을 수 있습니다. 체험용 키는 동시 요청 2개, 분당 60회라는 낮은 제한이 적용됩니다.