KO ▾

홈가이드

OpenAI 호환 무검열 API와 함께 SillyTavern 사용

claude code proxy sillytavern을 검색하셨다면, 요약하면 다음과 같습니다. SillyTavern에서 이 API를 사용하는 데 Claude Code나 프록시는 필요하지 않습니다. 내장된 OpenAI 호환 커넥션을 지원합니다.

서버에 케이블로 연결된 채팅 풍선과 가면을 가진 빛나는 무대로, 역할극 프론트엔드와 API를 나타냅니다.

주요 포인트

  1. Chat Completion을 사용하고, 그 다음 Custom (OpenAI-compatible) 소스를 사용하세요.
  2. 엔드포인트: https://api.claudecodeproxyapi.com/v1, 모델: uncensored
  3. 컨텍스트 크기를 최대 100,000 토큰까지 설정하고 스트리밍을 활성화하세요.
  4. 메시지당 8,000 토큰 입력 및 400 토큰 출력인 200개 메시지의 채팅 비용은 약 $0.28입니다.

SillyTavern에 프록시가 필요한가요?

"Claude Code", "proxy", "SillyTavern"이라는 단어는 검색 시 자주 혼동되므로 각 용어의 의미를 설명합니다. Claude Code는 Anthropic의 코딩 CLI이며 SillyTavern과 무관합니다. SillyTavern은 역할극 및 캐릭터 채팅을 위한 자체 호스팅 채팅 프론트 엔드입니다. 이전 OpenAI 설정에서는 사용자 지정 엔드포인트를 "reverse proxy"라고 부르며, 여기서 "proxy"라는 단어가 유래했습니다.

추가 서버를 실행할 필요가 없습니다. SillyTavern은 모든 OpenAI 호환 엔드포인트에 직접 연결할 수 있으며 https://api.claudecodeproxyapi.com/v1도 그 중 하나입니다. 모델 ID는 uncensored입니다. 이는 독립적인 제공업체에서 운영하는 오픈 웨이트 모델로, 합법적인 성인 사용을 위해 콘텐츠 거부 없이 답변하도록 조정되었습니다. Claude가 아니며 Anthropic이나 기타 벤더의 공식 API가 아닙니다. 유일한 엄격한 규칙은 미성년자가 관련된 성 콘텐츠는 절대 허용되지 않는다는 것입니다.

5단계로 연결

  1. API 키 페이지에서 키를 얻으세요. 가입 후 카드 없이 7일 유효한 무료 체험 크레딧 $0.50을 한 번의 클릭으로 청구할 수 있습니다.
  2. SillyTavern에서 플러그 아이콘(API Connections)을 열고 API를 Chat Completion로 설정하세요.
  3. Chat Completion Source를 Custom (OpenAI-compatible)로 설정하세요.
  4. Custom Endpoint (Base URL)에 https://api.claudecodeproxyapi.com/v1를 입력하세요. /chat/completions은 추가하지 마세요.
  5. 키를 Custom API Key에 붙여넣고, 모델 ID로 uncensored를 입력한 후 Connect를 누르세요.

초록색 상태 표시등과 모델 이름이 표시되면 성공한 것입니다. 메뉴 레이블은 SillyTavern 릴리스마다 약간씩 달라지므로, 버전에서 필드 이름이 다르게 표시되면 동일한 개념인 커스텀 OpenAI 스타일 URL을 허용하는 소스를 찾아보세요.

SillyTavern 외부에서 키를 먼저 테스트하세요

Connect가 실패하면 SillyTavern을 제외하세요. 이 요청은 uncensored를 포함하는 모델 목록을 반환해야 합니다:

curl https://api.claudecodeproxyapi.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

그리고 이 요청은 캐릭터 채팅이 보내는 방식대로 실제 응답을 테스트합니다:

curl https://api.claudecodeproxyapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Captain Rook, a gruff airship pilot."},
      {"role": "user", "content": "We lost the left engine. Orders?"}
    ],
    "temperature": 0.9,
    "stream": true
  }'

터미널에서는 둘 다 작동하지만 SillyTavern에서 실패하면 원인은 URL 필드의 오타 또는 남아 있는 설정입니다. 터미널에서도 실패하면 키를 확인하세요.

변경할 만한 설정

컨텍스트 크기

API는 프롬프트와 완료 합계가 100,000토큰인 컨텍스트 창을 제공합니다. SillyTavern의 컨텍스트 슬라이더가 이력을 조정하므로 채팅이 필요한 만큼 높이세요. 더 큰 컨텍스트는 더 풍부한 메모리를 의미하지만 메시지당 더 많은 입력 토큰을 의미하며, 이것이 비용의 원천입니다.

응답 길이

스타일에 맞는 최대 응답 길이를 설정하세요. API는 max_tokens를 선택 사항으로 처리하지만, 응답이 계속되는 것을 방지하고 비용을 예측 가능하게 유지합니다.

스트리밍

스트리밍을 활성화하면 응답이 단어 단위로 표시됩니다. 스트림은 SSE를 사용하며 종료 시 사용량을 보고합니다. 스트림은 완료될 때까지 동시 요청 슬롯을 하나 점유하므로 여러 채팅을 동시에 실행하는 경우 중요합니다: 전체 키는 8개의 동시 요청과 분당 300개의 요청을 허용하며, 체험 키는 2개와 60개를 허용합니다.

샘플링

Temperature, top_p, stop 시퀀스, seed 및 패널티가 전달됩니다. 생동감 있는 대화를 위해 temperature 0.9 근처에서 시작하세요. 캐릭터가 구문을 반복한다면 다른 설정을 변경하기 전에 작은 빈도 패널티를 추가하세요.

프롬프트 후처리

연결은 작동하지만 응답이 캐릭터 카드를 무시하는 경우, Custom 소스에 대한 프롬프트 후처리 옵션을 확인하고 다른 모드를 시도하세요. 일부 모드는 시스템 메시지를 병합하거나 순서를 변경하여 카드 읽기 방식에 영향을 줄 수 있습니다.

함수 호출 및 확장

API는 함수 호출을 지원합니다: tools, tool_choice, 스트리밍된 tool_calls 및 role: "tool"로 전송되는 결과. 프론트엔드에서의 함수 호출은 선택 사항이며 특정 기능에 의해 처리되므로, SillyTavern에서 이를 사용할 수 있는지 여부는 버전과 설치한 확장에 따라 다릅니다. 사용자 정의 캐릭터 도구 또는 확장을 빌드하는 경우 요청 형식은 표준 OpenAI 형식이며 문서에 예시가 있습니다. 일반 캐릭터 채팅에는 도구가 전혀 필요하지 않습니다.

JSON 모드는 또한 response_format: {"type":"json_object"}를 통해 사용할 수 있습니다. 이는 재고나 관계 상태 추적기처럼 구조화된 데이터를 모델에 요청하는 확장 프로그램에 도움이 됩니다.

채팅 비용

가격은 입력 토큰 1M당 $0.15, 출력 토큰 1M당 $0.50이며, 실패하거나 거부된 요청에는 요금이 부과되지 않습니다. 각 메시지가 카드, 로어북 및 이력에서 8,000 토큰을 보내고 400 토큰의 응답을 받는다고 가정해 봅시다:

  • 입력: 8,000 / 1,000,000 x $0.15 = $0.0012
  • 출력: 400 / 1,000,000 x $0.50 = $0.0002
  • 메시지당: $0.0014
  • 200개 메시지 채팅: 200 x $0.0014 = $0.28

따라서 $0.50 체험 크레딧은 긴 첫 번째 채팅을 커버할 수 있습니다. 충전은 $20부터 시작하며, $50부터 +5%, $100부터 +10%, $200부터 +15% 보너스가 제공되고 미사용 크레딧은 만료되지 않습니다. 이 사이트에서는 암호화폐(TRC20의 USDT 또는 Base의 USDC)로 결제합니다. 자세한 내용은 요금 페이지에서 확인할 수 있습니다. 동일한 엔드포인트를 코딩 CLI에 연결하려면 프록시 문제 해결 가이드에서 번역 프록시가 필요하고 여기서는 필요하지 않은 이유를 설명합니다.

캐릭터 카드를 저렴하게 유지하기

입력 토큰이 청구서의 대부분을 차지하며, 카드는 메시지마다 다시 전송됩니다. 캐릭터의 질을 해치지 않으면서 비용을 절감하는 몇 가지 습관이 있습니다:

  • 긴 배경 설정 서술 대신 말투, 목표 및 경계를 짧은 문장으로 카드를 작성하세요.
  • 로어북 항목을 특정 단어로 키를 지정하여 관련 항목만 삽입되도록 하세요.
  • 때때로 오래된 장면을 몇 줄로 요약한 후 원본 로그를 정리하세요.
  • 프롬프트 보기의 토큰 카운터를 확인하고 모델이 사용하지 않는 항목을 모두 제거하세요.

메시지당 평균 입력을 8,000에서 4,000 토큰으로 절반으로 줄이면 메시지 입력 부분의 비용이 $0.0012에서 $0.0006로 줄어들어 메시지당 $0.0006, 200개 메시지 전체로 $0.12를 절약할 수 있습니다.

자주 발생하는 문제

문제확인
연결 시 오류 표시URL은 /v1로 끝나야 하며 /chat/completions을 포함하지 않아야 합니다. 위의 curl 호출로 테스트하세요.
응답이 문장 중간에 끊김응답 길이 설정을 높이세요. API 자체는 컨텍스트 창 이하로 아무것도 제한하지 않습니다.
응답이 반복됨작은 빈도 또는 존재 패널티를 추가하고 온도를 약간 올리세요.
메시지가 많으면 채팅이 중단됩니다100,000토큰 컨텍스트 창에 도달했을 수 있습니다. 컨텍스트 슬라이더를 낮추거나 요약하세요
두 채팅을 실행할 때 429 오류 발생체험 키는 2개의 동시 요청을 허용합니다. 스트림을 중지하거나 전체 키를 받으려면 충전하세요.

지원팀에 문의할 때 실패한 응답의 X-Request-Id 헤더를 보내세요. 키 페이지는 붙여넣은 키가 현재 키인지 확인하는 곳이기도 합니다.

질문과 답변

이 API로 SillyTavern을 사용하려면 Claude Code가 필요합니까?

아니요. SillyTavern은 사용자 지정(OpenAI 호환) 소스를 통해 API에 직접 연결합니다. Claude Code는 별도의 코딩 도구입니다.

SillyTavern에 어떤 URL을 입력해야 합니까?

https://api.claudecodeproxyapi.com/v1을 커스텀 엔드포인트로 입력하고, /chat/completions 없이 입력하세요. 모델 ID로 uncensored를 사용하세요.

긴 세션에서 429 오류가 발생하는 이유는 무엇입니까?

분당 요청 수가 너무 많거나 동시에 너무 많은 요청을 보냈기 때문입니다. 스트리밍된 응답은 종료될 때까지 동시 요청 슬롯을 유지하며, Retry-After: 5가 포함된 429는 일시적인 과부하를 의미하므로 5초 동안 기다리세요.

이 모델이 Claude입니까?

아니요. 이는 독립적인 제공업체의 오픈 웨이트 모델이며, OpenAI 호환 API 뒤에 호스팅됩니다.

모든 콘텐츠가 허용됩니까?

이 모델은 합법적인 성인 사용에 대한 콘텐츠 거부 없이 답변하도록 튜닝되었습니다. 미성년자가 관련된 성 콘텐츠는 절대 허용되지 않습니다.

키는 양식 하나만 작성하면 받을 수 있습니다

계정을 생성하고 키를 복사한 후 기본 URL, 키, 모델 ID로 SillyTavern을 OpenAI 호환 무검열 API에 연결하세요.을 변경하세요. 설정은 이것으로 끝입니다.