문서
SillyTavern
SillyTavern의 Custom (OpenAI-compatible) 소스에는 기본 URL과 키가 필요합니다. Kunavo를 지정하면 Claude와 GPT가 모두 같은 모델 드롭다운에 표시됩니다.
SillyTavern을 Kunavo에 연결하려면 API Connections를 열고, API를 채팅 완료으로, 채팅 완료 소스를 사용자 지정(OpenAI 호환)으로 설정한 다음 두 필드를 입력하세요. Custom Endpoint = https://api.kunavo.com/v1, 사용자 지정 API 키 = 사용자의 sk-kn-… 키. Connect를 누르면 SillyTavern이 GET /v1/models를 호출하고 응답에서 모델 드롭다운을 채웁니다.
| SillyTavern 필드 | 값 |
|---|---|
| API | 채팅 완료 |
| 채팅 완료 소스 | 사용자 지정(OpenAI 호환) |
| 사용자 지정 엔드포인트(기본 URL) | https://api. |
| 사용자 지정 API 키 | sk-kn-… |
| 사용 가능한 모델 | Connect 후 자동으로 채워집니다 — 원하는 id를 선택하세요 |
/v1 접미사를 이 필드에 포함해야 합니다. SillyTavern의 사용자 지정 소스는 OpenAI 규칙에 따라 경로만 덧붙이므로, /v1 없이 https://api.kunavo.com만 입력하면 연결이 실패하고 모델 목록이 비게 됩니다.단계별 안내
/app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.- SillyTavern에서 상단 표시줄의 플러그 아이콘(API Connections)을 여세요.
- API를 채팅 완료으로 설정한 다음, 채팅 완료 소스를 사용자 지정(OpenAI 호환)으로 설정하세요.
- Custom Endpoint에
https://api.kunavo.com/v1를 붙여 넣고, 사용자 지정 API 키에 키를 입력하세요. - Connect를 누르세요. 상태가 녹색이고 사용 가능한 모델 드롭다운이 채워지면 연결된 것입니다.
- 드롭다운에서 모델 id를 선택해 채팅을 시작하세요. 나중에 모델을 바꿔도 다시 연결할 필요가 없습니다.
이 화면에 관한 SillyTavern 자체 참조 문서는 Chat Completions API 연결 페이지입니다.
UI를 디버깅하기 전에 확인하세요
한 번 요청하면 문제의 원인이 엔드포인트, 키, SillyTavern 중 어디에 있는지 확인할 수 있습니다. 이 요청에서 모델 id의 JSON 목록이 반환되면 같은 URL과 키로 드롭다운이 채워집니다.
# Confirms the key and the endpoint before you touch SillyTavern.
# A JSON list of model ids means the same URL will populate the dropdown.
curl -sS https://api.kunavo.com/v1/models \
-H "Authorization: Bearer sk-kn-..."선택할 모델
Kunavo의 모든 텍스트 모델은 같은 드롭다운에서 사용할 수 있습니다. 전체 목록은 모델 페이지에 있으며 GET /v1/models에서 실시간으로 가져옵니다. 요금은 토큰 1M개당 USD이며, 입력/출력 순입니다.
| 모델 ID | Kunavo 입력/출력 | 적합한 용도 |
|---|---|---|
claude-haiku-4-5 | $0.70 / $3.50 | 가장 저렴한 Claude — 턴당 비용이 가장 중요한 긴 세션에 적합 |
claude-sonnet-5 | $1.40 / $7.00 | 품질과 가격의 균형을 이루는 기본 선택 |
claude-opus-5 | $3.50 / $17.50 | 최고 품질의 Claude 등급 |
claude-fable-5 | $7.00 / $35.00 | 컨텍스트 윈도우가 1M 토큰인 최첨단 추론 모델 — 채팅 기록 자체가 문제일 때 적합 |
문제 해결
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| 연결 실패, 모델 목록이 비어 있음 | Custom Endpoint에서 /v1 누락 | https://api.를 사용하세요. 위의 curl 명령으로 확인하세요. |
| 401 / 유효하지 않은 키 | 키를 붙여넣을 때 공백이 포함되었거나 키가 폐기됨 | /app/에서 다시 복사하세요. 401 및 403 참조 |
| 응답이 스트리밍되지 않고 한꺼번에 도착함 | 연결 앞단의 프록시가 서버 전송 이벤트를 버퍼링함 | 엔드포인트 측 스트리밍을 지원합니다 — 스트리밍 오류 |
| 모델 id가 거부됨 | 이 엔드포인트에서 제공하지 않는 id | 드롭다운에서 선택하거나 model_not_found를 참조하세요 |
| 긴 채팅에서만 오류 발생 | 대화 기록이 모델의 컨텍스트 윈도우를 초과함 | 대화 기록을 줄이거나 컨텍스트가 더 긴 모델로 전환하세요 — context_length_exceeded |
솔직히 알려드릴 두 가지
제휴 관계 없음
SillyTavern은 독립적인 오픈 소스 프로젝트이며 Kunavo와 제휴 관계가 없습니다. SillyTavern이 임의의 OpenAI 호환 엔드포인트를 지원하기 때문에 작동하는 설정을 이 페이지에서 안내합니다. 어느 쪽에서도 이를 위한 별도 처리는 하지 않습니다.
콘텐츠 정책은 계속 적용됩니다
Kunavo를 통한 요청은 업스트림 제공업체에 전달되며, 각 제공업체는 전송된 콘텐츠에 자체 사용 정책을 적용합니다. 게이트웨이를 사용해도 이러한 제한은 없어지지 않습니다. 그렇지 않다고 안내하는 페이지는 무언가를 팔고 있는 것입니다. Kunavo 자체 약관은 허용되는 사용 정책에서 확인할 수 있습니다.
자주 묻는 질문
SillyTavern을 사용자 지정 API 엔드포인트에 연결하려면 어떻게 하나요?
SillyTavern에서 API Connections 탭(플러그 아이콘)을 열고 API를 Chat Completion으로, Chat Completion Source를 Custom (OpenAI-compatible)으로 설정하세요. Custom Endpoint에는 게이트웨이의 OpenAI 호환 기본 URL을 입력합니다. Kunavo의 경우 https://api.kunavo.com/v1입니다. Custom API Key에 키를 입력하고 Connect를 누르세요. 그러면 SillyTavern이 해당 엔드포인트에 GET /v1/models를 요청해 응답에서 모델 드롭다운을 채웁니다.
SillyTavern은 OpenAI 호환 엔드포인트를 통해 Claude 모델을 사용할 수 있나요?
네. SillyTavern의 Custom (OpenAI-compatible) 소스는 POST /v1/chat/completions를 구현한 엔드포인트만 있으면 되므로, 해당 형식으로 제공되는 Claude 모델은 SillyTavern의 별도 Anthropic 소스를 사용하지 않고도 작동합니다. Kunavo에서는 하나의 키로 Claude와 GPT 모델 id가 같은 드롭다운에 모두 표시되며, 모델을 전환할 때 다시 연결할 필요가 없습니다.
사용자 지정 엔드포인트를 사용할 때 SillyTavern에서 스트리밍이 작동하나요?
엔드포인트가 /v1/chat/completions에서 서버 전송 이벤트를 구현하면 스트리밍이 작동하며, Kunavo는 이를 지원합니다. 응답이 완성된 블록으로만 도착한다면, 대개 엔드포인트 자체가 아니라 연결 앞단의 프록시가 스트림을 버퍼링하기 때문입니다.
연결 후 SillyTavern의 모델 목록이 비어 있는 이유는 무엇인가요?
SillyTavern의 모델 드롭다운이 비어 있다는 것은 GET /v1/models 호출이 실패했다는 뜻이며, SillyTavern이 아니라 엔드포인트 또는 키 문제입니다. 흔한 원인은 기본 URL에 /v1 접미사가 빠졌거나 해당 엔드포인트에 유효하지 않은 키를 사용한 경우입니다. 같은 키로 /v1/models를 curl로 호출하면 SillyTavern 외부에서도 실패가 재현되어 두 원인 중 무엇인지 확인할 수 있습니다.