SillyTavern API 설정: base URL, API 키, 모델 목록
Updated 2026-07-15
SillyTavern에서 Chat Completion을 선택하고 소스를 Custom (OpenAI-compatible)로 설정한 다음 /v1으로 끝나는 base URL을 붙여넣고 API 키를 추가하세요. 그러면 모델 드롭다운이 프로바이더의 /v1/models 엔드포인트에서 자동으로 채워집니다.
빠른 답: 중요한 다섯 가지 설정
API Connections 패널(플러그 아이콘)을 열고 정확히 다음과 같이 설정하세요. API = Chat Completion. Chat Completion Source = Custom (OpenAI-compatible). Custom Endpoint (Base URL) = https://api.apisrouter.com/v1. Custom API Key = 본인의 sk-... 키. Connect를 클릭하고 초록불이 들어올 때까지 기다린 다음 드롭다운에서 모델을 선택하세요. 예를 들면 deepseek-v4-flash처럼요. 가장 흔한 실패 원인은 전체 경로를 붙여넣는 것입니다. SillyTavern은 입력한 값 뒤에 /chat/completions를 자동으로 붙이기 때문에 URL은 반드시 /v1에서 끝나야 합니다. https://api.apisrouter.com/v1/chat/completions를 붙여넣으면 SillyTavern이 /v1/chat/completions/chat/completions를 요청하게 되어 연결이 404로 실패합니다. 이는 프록시 설정에 전체 completions URL을 요구하는 JanitorAI와 정반대입니다. 같은 프로바이더라도 필드 규칙은 다릅니다.
SillyTavern API URL이 /v1에서 끝나는 이유
모든 OpenAI 호환 API는 base URL과 고정된 라우트 집합으로 구성됩니다. GET /v1/models는 본인의 키로 사용할 수 있는 모델 ID 목록을 반환합니다. POST /v1/chat/completions는 실제 채팅 요청을 실행합니다. SillyTavern은 이 라우트들을 이미 알고 있고 스스로 만들어내기 때문에 base 값만 물어봅니다. Connect를 클릭하면 본인의 키로 /v1/models를 호출하고 그 응답으로 모델 드롭다운을 채웁니다. 드롭다운이 비어있다면 거의 항상 이 호출이 실패했다는 뜻입니다. 올바른 API 모드를 고르는 것도 중요합니다. Chat Completion은 system, user, assistant 역할이 구조화된 메시지를 전송하며, 이는 호스팅되는 모든 OpenAI 호환 프로바이더가 기대하는 방식입니다. Text Completion은 하나의 원시 프롬프트 문자열을 전송하며 주로 KoboldCpp나 text-generation-webui 같은 로컬 백엔드를 위해 존재합니다. 호스팅된 API 키를 쓸 때는 Chat Completion을 사용하세요. 호스팅된 채팅 엔드포인트에 Text Completion을 선택하면 에러가 나거나 포맷이 깨지고, 그 모드에서 보이는 여러 샘플러도 어차피 전송되지 않습니다.
단계별 설정
Connect 후에도 드롭다운이 비어있다면 다음 세 가지를 순서대로 다시 확인하세요. URL이 /v1에서 끝나고 뒤에 경로나 공백이 없는지, 키가 따옴표나 공백 없이 붙여넣어졌는지, 소스가 일반 OpenAI가 아니라 Custom (OpenAI-compatible)로 되어 있는지입니다. 일부 버전에서는 일반 OpenAI 소스가 커스텀 URL을 무시하고 api.openai.com과 통신하는데, 그곳에서는 본인의 키가 유효하지 않습니다.
- 키를 발급받으세요. APIsRouter에는 계정 가입 양식이 없습니다. /topup에서 결제하면 키가 이메일로 발송됩니다. OpenAI 호환 키라면 어떤 것이든 이 단계에서 동일하게 작동합니다.
- SillyTavern에서 플러그 아이콘을 클릭해 API Connections를 엽니다.
- API를 Chat Completion으로 설정합니다.
- Chat Completion Source를 Custom (OpenAI-compatible)로 설정합니다.
- Custom Endpoint (Base URL)에 https://api.apisrouter.com/v1을 입력하고 /v1 뒤에는 아무것도 붙이지 않습니다.
- Custom API Key 필드에 본인의 키를 붙여넣습니다.
- Connect를 클릭합니다. 상태 표시등이 초록색으로 바뀌고 Available Models 드롭다운이 /v1/models로부터 채워집니다.
- 모델을 선택하고 캐릭터 카드를 연 다음 짧은 테스트 메시지를 보내보세요.
SillyTavern 밖에서 연결 확인하기
무언가 실패하면 SillyTavern 탓을 하기 전에 엔드포인트를 직접 테스트해보세요. 아래 curl 호출은 Connect 버튼이 하는 일과 정확히 동일합니다. 모델 ID의 JSON 배열이 반환된다면 키와 URL은 문제가 없고 문제는 SillyTavern 필드 쪽에 있는 것입니다. 모델 목록은 작동하는데 채팅이 실패한다면 동일한 base URL로 Python에서 실제 completion을 한 번 실행해보세요. 여기서 응답이 성공하면 전체 체인이 정상이라는 뜻이고, 돌아오는 에러 메시지는 SillyTavern의 일반적인 메시지가 아니라 프로바이더의 실제 에러입니다.
curl https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer sk-your-key"샘플러와 프리셋 기본
Chat Completion 소스는 temperature, top P, frequency penalty, presence penalty에 더해 응답 길이와 컨텍스트 크기라는 작은 샘플러 세트만 노출합니다. 어디선가 읽어봤을 법한 더 화려한 샘플러들(min P, mirostat, dynamic temperature)은 Text Completion 백엔드에 속하는 것으로 호스팅된 채팅 API에는 아예 전송되지 않으니 여기서 찾을 필요는 없습니다. SillyTavern의 프리셋은 두 가지를 함께 담고 있습니다. 샘플러 값들과, Prompt Manager가 캐릭터 카드, 페르소나, 로어북으로부터 조립하는 프롬프트 구조입니다. 기본 내장된 Default 프리셋은 무난한 출발점입니다. 한 번에 값 하나씩만 바꾸고 같은 장면을 다시 생성해보면서 실제로 어떤 효과가 있는지 확인하세요. 컨텍스트 크기는 특히 주의할 필요가 있습니다. SillyTavern은 채팅 기록으로 컨텍스트 윈도우를 채우기 때문에 컨텍스트가 커질수록 매 턴마다 더 많은 프롬프트 토큰이 전송되고, 이는 기억력을 향상시키는 동시에 메시지당 비용도 높입니다.
| 설정 | 시작값 | 롤플레이에서 하는 역할 |
|---|---|---|
| Temperature | 0.8 | 높이면(최대 1.1) 문장이 다양해지고, 캐릭터가 설정에서 벗어나면 낮추세요(0.6) |
| Top P | 0.95 | 응답이 앞뒤가 안 맞아지지 않는 한 그대로 두고, 그럴 때만 살짝 낮추세요 |
| Frequency penalty | 0.1 | 긴 채팅에서 반복되는 문장 리듬을 줄여줍니다 |
| Presence penalty | 0.05 | 작은 값으로도 주제가 맴도는 것을 막아줍니다 |
| Max response tokens | 350 | 300~500이면 장황해지지 않으면서 문단 형태의 응답에 알맞습니다 |
| Context size | 모델 한도 또는 16k | 턴마다 더 많은 기록을 담지만 메시지당 청구되는 입력 토큰도 늘어납니다 |
SillyTavern에 추천하는 모델
샘플러 튜닝보다 모델 선택이 더 중요합니다. 어디까지나 대략적인 커뮤니티 반응을 기준으로 보면 가격 대비로는 DeepSeek V4 계열이 1순위입니다. deepseek-v4-flash는 긴 채팅의 기본 추천이고, deepseek-v4-pro는 복잡한 카드와 그룹 채팅을 더 잘 유지합니다. GLM-5, Kimi K2.6, MiMo는 뚜렷한 문체를 가진 탄탄한 가성비 선택지로, 채팅이 비슷비슷하게 느껴지기 시작하면 번갈아 써볼 만합니다. Grok은 xAI의 공개 정책이 픽션 설정에서 성숙한 주제를 명시적으로 허용한다는 점에서 눈여겨볼 만하며, 이는 더 어두운 스토리라인에 중요합니다. Claude는 이 목록에서 가장 뛰어난 문장력을 보여주지만 Anthropic의 정책은 노골적인 콘텐츠를 금지하므로, Claude는 SFW 창작과 문학적 스타일의 장면을 위한 선택으로 다루는 것이 맞습니다. 실무적으로 두 가지만 기억하세요. 첫째, SillyTavern은 성인을 대상으로 한 소프트웨어이고, 여기 있는 모든 모델은 프론트엔드와 무관하게 각 프로바이더 고유의 콘텐츠 정책을 적용하므로 카드와 장면은 그 규칙 안에서 유지해야 합니다. 둘째, 드롭다운이 /v1/models로부터 실시간으로 채워지기 때문에 채팅 중간에도 모델을 바꿔서 같은 메시지에 대한 응답을 비교할 수 있으며, 이는 본인에게 맞는 모델을 가장 빠르게 찾는 방법입니다.
| 모델 ID | SillyTavern에서의 강점 | 콘텐츠 정책 참고사항 |
|---|---|---|
| deepseek-v4-flash | 긴 채팅에서 커뮤니티가 선호하는 모델. 메시지당 가성비 최고 | 픽션에 유연한 정책. 캐릭터 카드를 잘 따름 |
| deepseek-v4-pro | 복잡한 카드와 그룹 채팅에서 더 강한 지시 이행 능력 | Flash와 같은 계열이며 일관성이 더 좋음 |
| glm-5 | 뚜렷한 문체. 느린 장면에서 좋은 페이싱 | 서사 중심 채팅에 좋은 가성비 선택 |
| kimi-k2.6 | 방대한 로어북을 위한 긴 컨텍스트 기억력 | 가성비 선택. 큰 카드도 잊지 않고 처리 |
| grok-4.5 | 강력한 애드리브와 대화 티키타카 | xAI 정책은 픽션 설정에서 성숙한 주제를 허용 |
| claude-sonnet-4-6 | 가격 대비 최고의 문장력 | SFW 창작 전용. Anthropic은 노골적인 콘텐츠를 금지 |
| claude-opus-4-7 | 최고 수준의 장문 문학적 글쓰기 | Sonnet과 동일하게 SFW 전용 정책 |
| gemini-3.5-flash | 빠른 응답, 긴 컨텍스트 | 표준 Google 정책. 모험형 롤플레이에 적합 |
SillyTavern 채팅의 실제 비용
호스팅 모델은 토큰당 과금되며, 롤플레이는 입력이 무거운 편입니다. 매 턴마다 캐릭터 카드와 최근 기록을 다시 전송하기 때문입니다. 프롬프트 토큰 8,000개를 보내고 350토큰짜리 응답을 받는 턴은 deepseek-v4-flash 기준으로 1센트의 10분의 1 정도의 비용이라, 몇 달러면 캐주얼한 채팅을 몇 달치나 감당합니다. 같은 턴을 claude-opus-4-7에서 실행하면 비용이 약 25배 더 드는데, 그래서 대부분의 사람들이 저렴한 모델을 일상용으로 쓰고 프리미엄 모델은 신경 쓰는 장면에만 아껴둡니다. 하나의 게이트웨이 키로 이 표 전체를 커버할 수 있습니다. APIsRouter는 사용량 기반 과금에 구독이 없는 OpenAI 호환 게이트웨이입니다. 계정 생성 없이 /topup에서 결제하면 키가 이메일로 도착하고, 첫 충전에는 잔액에 동일한 금액만큼 +100%가 추가되며, 글로벌 모델은 공식 요금보다 20% 낮은 가격이고, 중국 모델은 공식 가격보다 낮은 가격입니다.
| 모델 | 입력 / 100만 토큰 | 출력 / 100만 토큰 |
|---|---|---|
| deepseek-v4-flash | $0.126 | $0.252 |
| deepseek-v4-pro | $0.3915 | $0.783 |
| glm-5 | $0.514 | $2.314 |
| gemini-3.5-flash | $1.20 | $7.20 |
| claude-sonnet-4-6 | $2.40 | $12.00 |
| claude-opus-4-7 | $4.00 | $20.00 |
| gpt-5.5 | $4.00 | $24.00 |
| grok-4.5 | $1.60 | $4.80 |
자주 묻는 질문
SillyTavern에 어떤 API URL을 입력해야 하나요?
base URL만, /v1으로 끝나는 형태입니다. APIsRouter의 경우 https://api.apisrouter.com/v1입니다. SillyTavern이 /chat/completions를 자체적으로 붙이기 때문에 전체 completions 경로를 입력하면 연결이 404로 끊깁니다.
SillyTavern에 무료 API가 있나요?
SillyTavern 자체는 무료 오픈소스 소프트웨어입니다. 호스팅 모델 이용은 토큰당 과금되지만, 일부 프로바이더는 빡빡한 레이트 리밋과 대기열이 있는 무료 티어를 제공합니다. 하드웨어가 감당할 수 있다면 KoboldCpp로 로컬 모델을 돌리는 것은 무료입니다. 실제로는 deepseek-v4-flash 같은 저가형 호스팅 모델이 메시지당 1센트도 안 되는 비용이라, 레이트 리밋의 고통 없이 캐주얼하게 쓰기에는 사실상 무료에 가깝습니다.
SillyTavern 모델 목록이 비어있는 이유는 무엇인가요?
/v1/models로의 Connect 호출이 실패한 것입니다. URL이 추가 경로나 공백 없이 /v1에서 끝나는지, 키가 깔끔하게 붙여넣어졌는지, 소스가 일반 OpenAI가 아니라 Custom (OpenAI-compatible)인지 확인하세요. curl로 /v1/models를 직접 테스트하면 프로바이더의 실제 에러를 확인할 수 있습니다.
SillyTavern에서 Chat Completion과 Text Completion 중 무엇을 써야 하나요?
호스팅된 OpenAI 호환 API라면 Chat Completion을 사용하세요. Text Completion은 원시 프롬프트 문자열을 받는 KoboldCpp나 text-generation-webui 같은 로컬 백엔드용입니다. 호스팅된 채팅 엔드포인트에 Text Completion을 선택하면 에러가 나거나 포맷이 깨집니다.
SillyTavern에서 롤플레이에 가장 좋은 모델은 무엇인가요?
저렴한 비용으로 긴 채팅을 하기에 커뮤니티에서 흔히 기본으로 쓰는 deepseek-v4-flash부터 시작하세요. 복잡한 카드에는 deepseek-v4-pro로 넘어가고, 다른 문체를 원한다면 GLM-5나 Kimi K2.6을 써보고, 최고 품질의 SFW 창작에는 Claude를 사용하세요. Grok은 xAI의 공개 정책에 따라 성숙한 픽션 주제에 적합합니다.
SillyTavern에서 내 API 키는 안전한가요?
키는 사용자 컴퓨터의 SillyTavern secrets.json에 로컬로 저장되며 설정한 API 호스트로만 전송됩니다. 연결 패널 스크린샷이나 내보낸 설정 파일을 공유하지 마시고, 유출이 의심되면 키를 재발급하세요.