SillyTavern API 설정: OpenAI 호환 연결 방법
sillytavern api 설정에서 연결 주소, 키, 모델 이름, 컨텍스트 값 등 헷갈리기 쉬운 부분을 확인용 명령어와 함께 설명합니다.
업데이트일
포인트
- 연결 방식은 Chat Completion의 Custom(OpenAI 호환)을 선택합니다
- URL은 https://api.mukenetsuapi.com/v1, 모델명은 uncensored
- 컨텍스트는 100,000까지 가능하지만 비용과 속도를 위해 줄이는 것이 현실적입니다
- 401은 키, 404는 URL, 429는 동시 실행 횟수 또는 요청 횟수 초과를 의심해 보세요

먼저 필요한 것 3가지를 준비하세요
sillytavern api 설정은 절차 자체는 짧지만, 많은 실수는 입력 값의 오류에서 비롯됩니다. 먼저 다음 3가지를 준비하세요.
- API 키: API 키 발급 페이지에서 생성합니다. 신규 등록 후 $0.50의 시험 크레딧을 원클릭으로 받을 수 있습니다.
- 베이스 URL:
https://api.mukenetsuapi.com/v1 - 모델 이름:
uncensored
SillyTavern은 OpenAI 호환 엔드포인트를 추가할 수 있는 프론트엔드입니다. 이 API는 OpenAI 호환이므로 공식 OpenAI를 선택할 필요가 없으며, Custom 엔드포인트로 등록할 수 있습니다.
연결 단계
메뉴 문구는 버전마다 다를 수 있습니다. 여기서는 일반적인 흐름을 설명합니다. 다른 경우 SillyTavern 자체 문서도 함께 참조하세요.
- 상단의 'API Connections'(플러그 아이콘)을 엽니다.
- API 유형으로 'Chat Completion'을 선택합니다.
- 소스 목록에서 OpenAI 호환 커스텀 연결(Custom)을 선택하세요.
- 엔드포인트 URL에
https://api.mukenetsuapi.com/v1를 입력합니다. 끝에/chat/completions은 붙이지 않습니다. - API 키란에 발급받은 키를 붙여넣습니다. 앞뒤 공백이 없도록 하세요.
- 모델 이름을
uncensored로 설정합니다. 목록에서 선택할 수 있으면 선택하고, 수동 입력 시에는 그대로 입력합니다. - 연결 버튼을 누르고 성공 메시지가 표시되는지 확인합니다.
연결 전에 터미널에서 키와 URL이 정확한지 확인하면 원인 파악이 쉬워집니다.
curl https://api.mukenetsuapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "messages": [{"role": "user", "content": "こんにちは"}], "max_tokens": 50}'응답이 반환되면 키, URL, 모델 이름이 정확합니다. 이 상태에서 SillyTavern이 실패하면 앱 측 입력을 의심할 수 있습니다.
컨텍스트와 응답 길이 결정
이 API의 컨텍스트는 프롬프트와 출력을 합해 최대 100,000 토큰까지 사용할 수 있습니다. 하지만 SillyTavern의 컨텍스트 크기를 최대치로 설정하는 것은 권장하지 않습니다. 매번 캐릭터 설정, 세계관, 이력을 다시 보내야 하므로 값이 클수록 1회 입력량이 늘어나기 때문입니다.
비용 계산 예시
컨텍스트를 16,000 토큰까지 사용하고 응답이 300 토큰인 경우, 메시지당 비용은 다음과 같습니다.
- 입력: 16,000 ÷ 1,000,000 × $0.15 = $0.0024
- 출력: 300 ÷ 1,000,000 × $0.50 = $0.00015
- 합계: $0.00255
100 메시지당 $0.255입니다. 컨텍스트를 8,000로 절반으로 줄이면 입력 측 비용은 약 절반이 됩니다. 단위 가격의 자세한 내용은 요금 페이지를 확인하세요.
참고
긴 소설이나 다수 캐릭터가 등장하는 장면이 아니라면, 8,000에서 16,000 정도로 시작해 캐릭터가 과거 사건을 잊는다고 느껴지면 컨텍스트를 늘리는 방식이 현실적입니다. 응답 최대 길이는 한 번의 응답으로 보고 싶은 길이에 맞춰 조정하세요. max_tokens은 선택 사항이지만, 응답이 너무 길어지는 것을 방지하려면 SillyTavern 측에서 제한을 설정해 두는 것이 안전합니다.
샘플링 설정 고려 사항
temperature, top_p, stop, seed 및 각종 패널티는 API에 그대로 전달됩니다. SillyTavern의 프리셋으로 조정할 수 있습니다.
- 같은 표현이 반복됨: frequency 또는 presence 패널티를 약간 높입니다.
- 답변이 산만함: temperature을 낮춥니다.
- 단조로움: temperature을 약간 높입니다.
- 비교 대상: seed를 고정하고 1개씩 값을 변경합니다.
프리셋 항목명은 SillyTavern 버전에 따라 다릅니다. 설정이 적용되지 않으면 사용 중인 연결 방식이 해당 항목을 지원하는지, SillyTavern 문서를 확인합니다.
자주 발생하는 오류 및 해결 방법
| 증상 | 원인 후보 | 해결 방법 |
|---|---|---|
| 401 | 키가 다름, 공백 혼입 | 키를 다시 붙여넣고 curl로 동일한 키를 테스트합니다. |
| 404 | URL이 다름 | /v1로 끝나는지 확인합니다. |
| 모델을 찾을 수 없음 | 모델명 철자 | uncensored를 소문자로 입력합니다. |
429 (concurrency) | 동시 요청이 너무 많음 | 스와이프 연타 또는 그룹 채팅 내 동시 생성을 줄입니다. |
429 (rate_limited) | 분당 요청 횟수 초과 | 잠시 기다립니다. |
429 (Retry-After: 5 포함) | 일시적 혼잡 | 5초 후 재시도합니다. |
전체 키의 한도는 동시 8개, 분당 300개이며, 체험 키는 동시 2개, 분당 60개입니다. 스트리밍 응답은 완료될 때까지 동시 연결 슬롯 1개를 사용합니다. 체험 키로 그룹 채팅을 실행하면 슬롯이 즉시 가득 찹니다.
잔액이 충분한지는 다음 명령어로 확인할 수 있습니다.
curl https://api.mukenetsuapi.com/v1/balance \
-H "Authorization: Bearer YOUR_API_KEY"응답 헤더의 X-Balance-USD에서도 확인할 수 있습니다. 모델 목록 확인은 GET /v1/models로 가능합니다.
curl https://api.mukenetsuapi.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"사용 시 주의사항
이 API는 텍스트 전용입니다. SillyTavern의 이미지 생성 또는 음성 기능을 사용하려면 별도 서비스가 필요합니다. 콘텐츠는 합법적인 성인용 범위 내에서 소설, 롤플레이, 컴패니언 앱 등의 픽션을 가정합니다. 미성년자가 관련된 성적인 콘텐츠는 모든 설정에서 생성되지 않습니다. 프롬프트는 모델 학습에 사용되지 않습니다.
더 자세한 파라미터는 문서를 참고하세요. 결제는 USDT(TRC20) 또는 USDC(Base)로 $20부터 $500까지 정수 금액으로 가능합니다.
기타 가이드
자주 묻는 질문
SillyTavern에서 사용할 모델명은 무엇입니까.
uncensored입니다. 소문자로 그대로 입력하세요.
URL 끝에 /chat/completions이 필요합니까.
불필요합니다. 베이스 URL은 /v1까지만 설정하면 되며, 나머지 경로는 앱 측에서 추가합니다.
체험 키로 충분합니까.
연결 확인이나 짧은 대화에는 충분합니다. 하지만 체험 키는 동시 2개, 분당 60개로 제한되며 유효 기간이 7일이므로, 그룹 채팅을 사용하려면 일반 키로 충전하세요.
이미지도 생성할 수 있습니까.
불가능합니다. 이 API는 텍스트 전용이며 이미지, 음성, 비디오 생성을 지원하지 않습니다.
컨텍스트는 얼마로 설정해야 합니까.
최대 100,000 토큰이지만, 8,000에서 16,000 정도로 시작해 보는 것이 현실적입니다. 컨텍스트가 클수록 매번 입력량이 증가하여 비용이 더 듭니다.
API 키는 1개의 폼으로 획득 가능합니다.
계정 생성, 키 복사, Base URL 변경. 이거면 설정이 모두 완료됩니다.