실리태번(SillyTavern)에 TavernAPI 연동하는 법

$0.30 무료 체험 받기

실리태번에 TavernAPI를 연결하려면 상단의 API Connections 패널을 열고 Chat Completion → Custom (OpenAI-compatible)을 선택한 뒤, https://tavernapi.com/v1 주소와 API 키를 붙여넣고 Connect를 누른 다음 모델 ID를 고르고, 전용 스토리텔링 규칙을 쓰고 싶다면 프리셋 JSON을 임포트하세요.

Custom Endpoint (Base URL)
https://tavernapi.com/v1
API 키 형식
sk-tav-...

  1. 1단계: TavernAPI 콘솔에서 API 키 발급받기

    이메일 주소, Google 또는 Discord 계정으로 TavernAPI 콘솔에 로그인하세요. 이메일 인증을 마치면 $0.30 무료 체험 크레딧(Gemini 4 Argon 및 Gemini 3.8 Flash 사용 가능)이 지급됩니다. 왼쪽 메뉴의 API keys 탭으로 이동해 Create API key를 클릭하고, 화면에 표시된 sk-tav-... 키를 바로 복사해 두세요—전체 키는 생성 직후 한 번만 표시됩니다.

  2. 2단계: 실리태번을 Custom (OpenAI-compatible)으로 설정하기

    실리태번을 열고 화면 상단의 API Connections 아이콘(플러그 모양)을 클릭한 뒤 아래 항목을 순서대로 입력하세요:

    • API: Chat Completion
    • Chat Completion Source: Custom (OpenAI-compatible)
    • Custom Endpoint (Base URL): https://tavernapi.com/v1
    • Custom API Key: 복사해 둔 sk-tav-... 키 붙여넣기

  3. 3단계: Connect 클릭 후 모델 ID 선택하기

    Connect 버튼을 누르면 실리태번이 사용 가능한 모델 목록을 자동으로 불러옵니다. Available Models 드롭다운을 열어 표준 모델 ID를 선택하세요: gemini-4-argon(대다수 유저 추천 1순위), claude-opus-5.5(최고의 장면 개연성과 캐릭터 해석), gemini-3.8-flash, deepseek-v4-pro 또는 claude-sonnet-5.5.

  4. 4단계: TavernAPI 프리셋 임포트하기 (또는 개인 프리셋 사용)

    서버 잠금 방식의 롤플레잉 프리셋을 쓰려면 TavernAPI 콘솔의 Presets 탭에서 프리셋 JSON을 다운로드한 뒤, 실리태번 왼쪽 상단의 AI Response Configuration 패널(슬라이더 아이콘)을 열고 Import preset을 클릭하세요. 일반 텍스트 규칙(분량 조절, 출력 언어, 유저 사칭 방지 등)은 자유롭게 토글하거나 수정할 수 있으며, 잠금 처리된 핵심 블록([[tav:pack/block]])은 서버에서 자동으로 펼쳐집니다. 직접 만든 로컬 프리셋을 쓰고 싶다면 기존 프리셋을 그대로 두세요—직접 연결 시에도 자동 프롬프트 캐싱은 똑같이 적용됩니다.

$0.30 무료 체험 받기

자주 발생하는 오류 코드 해결법

401 Unauthorized

API 키가 비어 있거나 오타가 있거나, 이미 폐기된 키입니다.

Custom API Key 칸에 앞뒤 공백 없이 sk-tav-... 키 전체가 제대로 들어갔는지 확인하거나, 콘솔에서 새 키를 발급받아 넣어보세요.

402 Insufficient Balance

현재 계정 잔액이 이번 요청의 예상 비용보다 부족합니다.

콘솔에서 기본 잔액을 충전하거나 30일 크레딧 팩을 구매하거나 리딤 코드를 등록하세요. 만약 실리태번의 Max Response Length (max_tokens) 값이 지나치게 높게 잡혀 있다면 적당한 수준으로 낮춰보세요.

403 Forbidden (Trial or Locked Preset)

무료 체험 크레딧으로 체험 대상 외의 모델을 호출했거나(체험 크레딧은 gemini-4-argon과 gemini-3.8-flash만 지원), 현재 실리태번 프리셋에 아직 계정에 해금되지 않은 [[tav:pack/block]] 팩이 포함되어 있습니다.

무료 체험 중이라면 모델을 gemini-4-argon 또는 gemini-3.8-flash로 바꾸고 유료 프리셋 팩을 비활성화하세요. Standard 프리셋은 $5 이상 첫 충전 시 해금되며, Pro 프리셋은 $4.99 단품 구매, $19/$39 크레딧 팩 활성화, 또는 누적 결제 금액 $25 달성 시 해금됩니다.

429 Too Many Requests / Upstream Busy

짧은 시간에 요청을 너무 빠르게 보냈거나, 스트리밍이 시작되기 전에 상위 경로가 일시적으로 혼잡한 상태입니다.

몇 초만 기다렸다가 스와이프/재생성(Regenerate)을 눌러보세요. 상위 서버 오류로 답변이 시작되지 않은 요청은 절대 과금되지 않습니다.

다음 단계

프리셋 요금 및 모델