자주 묻는 질문 (FAQ)
이 페이지에서는 Tavern Studio 설치, 설정 및 문제 해결 과정에서 자주 제기되는 일반적인 질문과 답변을 모아 소개합니다.
대상 독자
- API 연결 오류, 가져오기 실패, 로컬 모델 연산 크래시 등으로 진행이 막힌 사용자
- 로컬 데이터 저장소 구조 및 계정 요건을 정확히 파악하고 싶은 사용자
- 월드북 매칭 로직이나 GGUF 미세 튜닝 설정을 확인하려는 고급 사용자
배울 내용
- API 연결 실패의 원인 진단
- 캐릭터 카드 가져오기 오류 해결
- 로컬 모델 구동 시 메모리 한계 완화 방안
- 월드북 설정의 키워드 매칭 상태 점검
- 로컬 데이터 저장소의 기본 위치
자주 묻는 질문
Q1: Tavern Studio를 사용하려면 계정이 필요한가요?
로컬 클라이언트 환경을 사용하는 데 Tavern Studio 자체 웹사이트 계정은 필요하지 않습니다. 다만, 클라우드 API를 연동하여 모델을 구동하려는 경우 해당 타사 모델 서비스 제공업체의 계정 및 API 키가 별도로 필요합니다.
Q2: API 연결이 계속 실패하는 이유는 무엇인가요?
먼저 다음 사항들을 하나씩 확인해 주십시오:
- 입력한 기본 URL(Base URL)의 오탈자 여부 및 끝부분
/v1주소 포함 상태. - 사용한 API 키(API Key)가 유효하며 올바르게 복사되었는지 여부.
- API 계정의 잔액(Balance) 및 남은 크레딧 할당량(Quota).
- 네트워크 환경상의 인터넷 연결 상태 및 프록시 설정 오류 여부.
- 선택한 모델이 대화 텍스트 생성 기능을 공식적으로 지원하는 모델인지 여부.
Q3: 캐릭터 카드 가져오기가 실패하는 이유는 무엇인가요?
가져오려는 이미지 파일 내부에 캐릭터 프로필 메타데이터가 아예 포함되어 있지 않거나, 전송 과정에서 압축되어 손실되었기 때문입니다. 가급적 다른 플랫폼의 압축 필터링을 거치지 않은 원본 PNG 캐릭터 카드를 가져와 사용해 보십시오.
Q4: 암호화된 카드가 복호화되지 않는 이유는 무엇인가요?
비밀번호가 잘못 입력되었거나 파일 자체가 비정상적으로 수정되어 깨졌을 수 있습니다. 원본 카드 파일 상태를 복사하고 올바른 비밀번호를 다시 확인해 보세요.
Q5: 월드북 키워드가 활성화되지 않는 이유는 무엇인가요?
해당 설정 항목이 활성화(Enabled) 상태로 체크되어 있는지, 설정된 트리거 키워드가 실제 대화 콘텍스트에 정확히 등장했는지, 그리고 월드북 자체가 해당 채팅방에 정상적으로 연결(Bind)되어 있는지 검토하십시오.
Q6: 로컬 GGUF 모델을 구동하면 크래시가 발생하는 이유는 무엇인가요?
대부분 모델 연산에 필요한 하드웨어 메모리 용량을 초과하여 컴퓨터의 메모리가 부족해지기(Out of Memory) 때문입니다. GPU 오프로드 레이어(GPU Layers) 개수를 낮추거나, 콘텍스트 크기(Context size)를 줄이거나, 크롬 등 메모리를 많이 먹는 다른 백그라운드 프로그램을 닫거나, 파라미터가 더 작은 가벼운 모델을 구합시다.
Q7: 프리셋을 수정했는데 왜 채팅에 적용되지 않나요?
해당 대화방 전용으로 채팅 레벨 프리셋이 덮어씌워져 있을 수 있습니다. 대화 창의 채팅 설정(Chat Settings)을 열어 현재 어떤 프리셋이 연동되어 구동 중인지 검사하세요.
Q8: 로컬 데이터는 어디에 저장되나요?
사용하시는 OS 플랫폼 및 앱 빌드 버전에 따라 다릅니다. Windows 환경의 경우 통상적으로 사용자의 AppData 폴더 하위에 저장됩니다. 무설치 휴대용(Portable) 모드를 실행하는 경우 앱 실행 파일이 있는 폴더 바로 옆에 데이터가 저장되기도 합니다.