SillyTavern에서 DeepSeek API 사용법: 커스텀 엔드포인트

5단계로 설정하기

SillyTavern에서 deepseek api sillytavern 사용법은 한 가지 사실에 불과합니다: SillyTavern은 모든 OpenAI 호환 엔드포인트와 통신할 수 있으므로 URL, 키, 모델 ID만 제공하면 됩니다. 이 서비스는 공식 DeepSeek API가 아닙니다. ID uncensored의 오픈 웨이트 모델을 호스팅하며, 독립 제공업체가 운영하며 합법적인 성인 사용에 맞게 콘텐츠 거부 없이 응답하도록 조정되었습니다.

1. 계정을 생성하고 API 키 페이지로 이동하세요. 키를 복사합니다. 신규 사용자는 카드 없이 한 번의 클릭으로 $0.50의 무료 체험 크레딧을 받을 수 있으며, 7일 동안 유효합니다.
2. SillyTavern에서 API Connections 탭(상단 바의 플러그 아이콘)을 엽니다.
3. API 유형을 Chat Completion으로 설정합니다. 그런 다음 Chat Completion Source를 Custom (OpenAI-compatible)로 설정합니다.
4. 커스텀 엔드포인트 필드에 https://api.deepseekapi.top/v1을 입력합니다. API key 필드에 키를 붙여넣습니다. model ID 필드에 uncensored를 입력합니다.
5. Connect를 누릅니다. 녹색 상태 표시등과 모델 이름이 표시되면 연결이 성공한 것입니다.

SillyTavern 버전 간에 레이블 이름이 약간 달라질 수 있지만 개념은 동일합니다: Chat Completion 모드, Custom 소스, 엔드포인트, 키, 모델. 키는 API 키 페이지에서 가져옵니다.

연결 실패 시

순서대로 다음 항목을 확인하세요. 대부분의 실패는 이 중 하나 때문입니다.

• 잘못된 URL 형식. 엔드포인트는 /v1로 끝납니다. /chat/completions을 추가하지 마세요.
• 잘못된 소스. Text Completion 모드는 다른 요청 형식을 사용합니다. 이 API는 POST /v1/chat/completions 및 GET /v1/models을 제공하므로 Chat Completion을 사용하세요.
• 키에 공백이 포함되어 붙여넣음. 다시 붙여넣고 뒤에 공백이 있는지 확인하세요.
• 서버가 인터넷에 접근할 수 없습니다. SillyTavern을 홈 서버나 컨테이너에서 실행하는 경우, 머신에 아웃바운드 HTTPS 접근 권한이 필요합니다.

SillyTavern 문제를 키 문제와 구분하려면 터미널에서 키를 테스트하세요:

Copycurl https://api.deepseekapi.top/v1/models   -H "Authorization: Bearer YOUR_KEY" | grep uncensored

uncensored가 포함된 JSON 목록은 키가 유효함을 의미합니다. 채팅 라우트 자체를 확인하려면:

Copycurl https://api.deepseekapi.top/v1/chat/completions   -H "Authorization: Bearer YOUR_KEY"   -H "Content-Type: application/json"   -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Say hello in one sentence."}]}'

역할극에 중요한 설정

스트리밍

Chat Completion 패널에서 스트리밍을 켜세요. API는 생성되는 대로 토큰을 SSE로 전송하므로 응답이 작성되는 동안 표시됩니다. 스트리밍된 요청은 스트림이 끝날 때까지 동시성 슬롯 중 하나를 점유합니다. 전체 키는 최대 8개까지, 체험 키는 최대 2개까지 허용됩니다.

컨텍스트 크기

이 모델은 프롬프트와 완성을 합쳐 100,000 토큰의 컨텍스트 윈도우를 제공합니다. 모두 사용할 필요는 없습니다. SillyTavern은 캐릭터 카드, 페르소나, lorebook 항목 및 설정한 제한에 맞는 채팅 기록을 모든 메시지에 보냅니다. 제한을 줄이면 요금이 줄고 응답이 빨라집니다. 대부분의 채팅에는 16k에서 32k 토큰이 충분합니다.

최대 응답 길이

응답 제한을 400~600 토큰처럼 합리적인 값으로 설정하여 응답이 에세이로 길어지지 않도록 하세요. API는 max_tokens를 필수로 요구하지 않지만, 제한을 두면 크레딧이 과도한 출력으로 소모되는 것을 방지합니다.

샘플링

Temperature, top_p, stop 시퀀스, seed 및 페널티는 모델에 전달됩니다. 캐릭터 채팅의 일반적인 시작점은 temperature 0.8~1.0 및 top_p 약 0.9입니다. 한 번에 하나의 값만 변경하세요. 캐릭터가 구문을 반복한다면 temperature 대신 frequency 또는 presence 페널티를 약간 높입니다.

정지 시퀀스

모델이 사용자의 대사도 쓰기 시작하면 정지 시퀀스로 사용자 이름 뒤에 콜론을 추가하세요. 이는 전달됩니다.

첫 실행 체크리스트

좋아하는 캐릭터를 로드하기 전에 짧은 테스트 채팅을 실행하여 연결이 정상인지 확인하세요.

1. 빈 캐릭터를 생성하거나 기본 어시스턴트 카드를 사용하세요.
2. "ready라는 단어로 답해 주세요."를 전송하세요. 응답은 1~2초 내에 도착하고 생성되는 대로 스트리밍되어야 합니다.
3. 아무것도 표시되지 않으면 SillyTavern 콘솔 또는 네트워크 로그를 확인하세요. 401은 키가 잘못되었음을, 404는 URL 또는 모델 ID가 잘못되었음을, 429는 제한에 도달했음을 의미합니다.
4. 잔액을 확인하세요. 각 응답에는 X-Balance-USD 헤더가 포함되어 있으므로 메시지가 전송될 때마다 크레딧이 약간 감소하는 것을 확인할 수 있습니다.
5. 그 후에 실제 캐릭터 카드와 lorebook을 로드하세요.

응답이 비어 있거나 문장 중간에 잘린 경우 응답 길이 설정을 먼저 확인하세요. 제한이 너무 낮게 설정되면 응답이 조기에 종료되며, 이는 모델의 오류가 아닙니다.

프리셋 간 이동

SillyTavern은 샘플링 프리셋을 연결 프로필과 별도로 유지합니다. 높은 temperature로 내러티브 작성을 위한 프리셋 하나와 낮은 temperature로 짧은 사실적 응답을 위한 프리셋 하나를 저장해 두는 것이 좋습니다. 프리셋을 전환해도 엔드포인트나 키에는 영향을 미치지 않습니다.

롤플레이 세션의 비용

가격은 선불 크레딧 기준 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50이며 구독은 없습니다. 이력이 다시 전송되므로 입력이 더 큰 부분을 차지합니다. 메시지당 20,000 토큰의 프롬프트와 400 토큰의 응답으로 채팅을 진행하면:

• 입력: 20,000 × $0.15 / 1,000,000 = $0.003
• 출력: 400 × $0.50 / 1,000,000 = $0.0002
• 합계: 메시지당 $0.0032

따라서 100개의 메시지는 $0.32가 듭니다. 이제 동일한 응답을 가진 8,000 토큰의 잘린 컨텍스트를 비교해 보세요: 8,000 × $0.15 / 1,000,000 = $0.0012, 여기에 $0.0002를 더해 메시지당 $0.0014, 100개당 $0.14가 됩니다. 컨텍스트를 줄이면 동일한 턴 수에 대해 비용이 절반 이하로 줄어듭니다.

$0.50 체험금은 큰 크기(0.50 / 0.0032 = 156.25) 기준 약 156개의 메시지 또는 작은 크기(0.50 / 0.0014 = 357.1) 기준 약 357개의 메시지를 커버합니다. 실패하거나 거부된 요청에는 요금이 부과되지 않으며 크레딧은 만료되지 않습니다. 충전 금액, 보너스 및 결제 방법은 가격 책정 페이지를 참조하세요. 카드(Visa, Mastercard, Apple Pay, Google Pay)와 암호화폐(TRC20의 USDT, Base의 USDC)가 모두 허용됩니다.

캐릭터, 안전성 및 단 하나의 엄격한 규칙

이 모델은 성인용 픽션, 역할극 및 컴패니언 앱에 맞춰져 있습니다. 일반적인 안전 필터가 아니며, 귀하에게 적합한 콘텐츠를 결정하지 않습니다. 그것은 귀하의 책임입니다: 카드와 채팅을 합법적인 성인 사용에 한정하세요.

단 하나의 고정된 제한은 미성년자가 관련된 성적 콘텐츠가 허용되지 않는 것이며, 어떤 프롬프트도 이를 변경할 수 없습니다. 캐릭터의 나이를 카드에서 명확히 성인으로 유지하세요.

채팅의 품질을 높이는 몇 가지 실용적인 습관이 도움이 됩니다:

• 캐릭터의 핵심 정보를 카드 하단이 아닌 상단에 배치하세요.
• 내레이터의 스타일과 응답 길이를 설정하는 짧은 시스템 프롬프트를 사용하세요.
• SillyTavern의 요약 기능을 사용해 이전 채팅 내용을 요약하고, 무한정 유지하지 마세요.
• lorebook 항목은 짧게 유지하고 키워드로 트리거되도록 설정해 필요할 때만 프롬프트에 포함되게 하세요.

프롬프트는 학습에 사용되지 않습니다. 퀵스타트 문서를 참조해 잔액을 표시하는 X-Balance-USD를 포함한 응답 헤더를 확인하세요.

캐릭터를 컴패니언 앱 백엔드로 사용하기

일부 사용자는 SillyTavern을 성인용 장시간 실행되는 컴패니언 캐릭터용 프론트엔드로 사용합니다. 모든 채팅과 동일한 규칙이 적용됩니다. 캐릭터의 일관성을 유지하려면 짧은 고정 블록으로 페르소나를 작성하고, 요약 기능으로 이전 이벤트를 처리하세요. 세션 간 긴 공백은 크레딧이 만료되지 않고 구독이 없으므로 비용이 들지 않습니다.

나중에 SillyTavern 대신 자체 앱을 구축한다면 코드에서 동일한 엔드포인트를 호출할 수 있습니다. 퀵스타트 문서에는 동일한 Base URL과 모델 ID를 사용한 curl, Python, Node 예제가 있으므로, SillyTavern에서 작동하는 프롬프트를 직접 이동할 수 있습니다.

혼잡한 채팅의 속도 제한

단일 채팅은 제한에 도달하기 어렵습니다. 그룹 채팅, 스와이프, 여러 열린 탭은 가능합니다. 서비스는 분당 요청 수 제한(체험 키는 60, 전체 키는 300)을 초과하면 rate_limited 코드의 HTTP 429로 응답하고, 처리 중인 요청이 너무 많으면 concurrency로 응답합니다(체험은 2, 전체 키는 8).

일시적 과부하 시 Retry-After: 5 헤더와 함께 429도 반환합니다. 5초 대기 후 다시 전송하는 것이 올바른 대응입니다. 체험 키에서 이러한 현상이 발생하면 추가 탭을 닫거나 다른 스와이프를 시작하기 전에 현재 스와이프를 중지하세요.

더 많은 가이드

• Cursor에서 DeepSeek API 사용하는 방법: 커스텀 Base URL 설정
• DeepSeek API Python 예제: 채팅, 스트리밍, 도구
• DeepSeek API 키: 무검열 LLM API 접근