TavernAPI 롤플레잉 프리셋은 어떻게 작동하나요?
TavernAPI 프리셋을 쓰려면 콘솔에서 프리셋 JSON을 받아 실리태번에 임포트한 뒤, 표준 모델 ID(예: gemini-4-argon 또는 claude-opus-5.5)를 선택하세요. 프롬프트 배치 순서와 커스텀 토글은 실리태번 로컬에서 직접 제어하고, 잠금 처리된 [[tav:pack/block]] 플레이스홀더는 게이트웨이 서버가 핵심 작문 지시문으로 자동 치환해 전달합니다.
프롬프트 순서는 실리태번에 두고 핵심 블록만 서버에 잠근 이유
잘 만든 실리태번 프리셋은 크게 두 부분으로 나뉩니다. 하나는 유저가 직접 켜고 끄거나 순서를 바꾸고 싶어 하는 수십 개의 선택형 토글과 정규식·슬롯이고, 다른 하나는 AI 특유의 클리셰를 잡기 위해 수개월간 다듬은 핵심 스토리텔링 지시문입니다. 프리셋 전체를 서버에 넣어버리면 로컬 토글의 자유도가 사라지고, 반대로 핵심 지시문을 평문 JSON으로 배포하면 하루아침에 복제되어 유출되는 문제가 생깁니다.
우리는 역할을 깔끔하게 나누어 이 문제를 해결했습니다. 프롬프트 순서 배치와 커스텀 토글은 실리태번이 담당하고, 비공개 핵심 텍스트는 서버가 보관합니다. 콘솔에서 다운로드한 프리셋 파일을 열면 잠금 항목들도 일반 Prompt Manager 항목처럼 이름이 표시되어 마음대로 켜고 끄거나 드래그해 순서를 바꿀 수 있지만, 본문에는 [[tav:pack/block]] 같은 플레이스홀더 한 줄만 들어 있습니다. 실리태번이 조합된 요청을 https://tavernapi.com/v1 으로 보내면, 게이트웨이가 각 플레이스홀더를 실제 지시문으로 치환하고 {{char}}와 {{user}} 매크로를 전개한 뒤 프롬프트 캐시 중단점을 자동으로 설정합니다. Tavern Helper 같은 별도 플러그인은 전혀 필요 없으며, 프리셋은 오직 TavernAPI를 통해서만 작동합니다.
로컬에서 직접 커스텀하는 항목 vs 서버에서 처리되는 항목
실리태번의 AI Response Configuration 패널에 TavernAPI 프리셋을 임포트하면 각 구성 요소는 다음과 같이 작동합니다:
- 자유롭게 수정 가능한 오픈 항목
- 답변 길이(분량 조절), 출력 언어, 서술 시점, 유저 사칭 방지(AI가 {{user}}의 대사나 행동을 대신 쓰는 현상 차단) 토글은 모두 평문으로 열려 있습니다. 언제든 내용을 직접 수정하거나 켜고 끌 수 있고, 나만의 커스텀 프롬프트 행을 추가해도 됩니다.
- 잠금 처리된 핵심 블록 ([[tav:pack/block]])
- 핵심 스토리텔링, 캐릭터 말투 유지, AI 클리셰 억제 항목들은 Prompt Manager 목록에 이름이 그대로 표시되어 켜고 끄거나 순서를 바꿀 수 있으며, 본문의 [[tav:pack/block]] 플레이스홀더는 모델을 호출하기 직전에 서버에서 자동으로 펼쳐집니다.
- 캐릭터 카드, 페르소나 & 로어북
- 실리태번이 여전히 로컬에서 프롬프트를 조립하기 때문에 캐릭터 카드 설명(Description), 성격(Personality), 시나리오(Scenario), <user> 페르소나, 월드 인포 / 로어북 항목(@depth 삽입 포함), 작가 노트(Author's Notes), 정규식 스크립트까지 전부 평소와 똑같이 작동합니다.
- 전용 프리셋 없이 순수 모델만 연결하기
- 전용 프리셋 사용은 100% 선택 사항입니다. 본인이 쓰던 로컬 실리태번 프리셋을 그대로 쓰고 싶거나 RisuAI, JanitorAI 같은 다른 프론트엔드에서 연결할 때는 똑같이 모델 ID(예: gemini-4-argon 또는 claude-opus-5.5)만 고르세요—[[tav:...]] 플레이스홀더가 없는 요청은 자동 프롬프트 캐싱만 적용되어 원본 그대로 전달됩니다.
- Standard 프리셋 해금 조건
- 첫 $5 이상 충전을 완료하는 즉시 계정에 영구 해금됩니다.
- Pro 프리셋 해금 조건
- 세 가지 방법으로 이용 가능: $4.99 단품 구매, 활성화된 $19 또는 $39 30일 크레딧 팩 이용 기간 중 무료 사용, 또는 누적 결제 금액 $25 달성 시 영구 해금.
4단계로 끝나는 TavernAPI 프리셋 다운로드 및 임포트 방법
TavernAPI 콘솔의 Presets 탭에서 프리셋 JSON을 받아 실리태번의 Chat Completion Presets에 임포트하세요—별도 플러그인이나 추가 파일은 필요 없습니다.
로그인한 유저라면 누구나 콘솔에서 프리셋 파일을 둘러보고 다운로드할 수 있습니다(파일 안에는 비공개 텍스트가 들어 있지 않으며, 메시지를 보낼 때 게이트웨이가 계정의 프리셋 해금 권한을 확인합니다):
- TavernAPI 콘솔에 로그인한 뒤 왼쪽 사이드바에서 Presets 페이지를 열고 원하는 프리셋 팩의 Download를 클릭하세요.
- 실리태번 왼쪽 상단의 AI Response Configuration 아이콘(슬라이더 모양)을 누르고 Chat Completion Presets 옆의 Import preset을 클릭하세요.
- 다운로드한 TavernAPI-<name>-<version>.json 파일을 선택하고, 스토리에 맞게 평문 토글(분량, 출력 언어 등)을 켜세요.
- API Connections(플러그 아이콘)에서 https://tavernapi.com/v1 에 연결한 뒤 드롭다운에서 모델 ID(예: gemini-4-argon 또는 claude-opus-5.5)를 선택하세요.