SillyTavern에서 DeepSeek API 키: API 연결

빠른 설정

sillytavern 설정을 위한 deepseek api 키에 대해 먼저 한 가지 명확히 할 점이 있습니다. DeepSeek 자체 플랫폼에서 발급된 키는 DeepSeek의 엔드포인트용입니다. 이 사이트에서 얻는 키는 별도의 서비스에 속합니다: 콘텐츠 거부 없이 답변하도록 튜닝된 오픈 웨이트 모델을 실행하는 독립적인 OpenAI 호환 API입니다. DeepSeek의 공식 API가 아니므로 이 사이트의 키는 이 사이트의 Base URL에서만 사용하십시오.

SillyTavern에 입력할 값은 다음과 같습니다:

• 소스: Chat Completion, 그다음 Custom (OpenAI 호환)
• 사용자 정의 엔드포인트 (베이스 URL): https://api.deepseekapikey.com/v1
• API 키: 계정에서 발급받은 키
• 모델 ID: uncensored

SillyTavern은 자주 업데이트되므로 릴리스 간 메뉴 레이블이 약간 달라질 수 있습니다. 이름이 다를 경우 의미를 기준으로 일치시키세요. 이 페이지의 나머지 부분에서는 긴 캐릭터 채팅에 중요한 각 단계와 설정을 자세히 설명합니다.

인터페이스 단계별 안내

1. 키를 얻으세요. Google 또는 이메일과 비밀번호로 API 키 페이지에서 가입하세요. 신규 사용자는 카드 없이 한 번의 클릭으로 7일 유효한 $0.50의 무료 체험 크레딧을 청구할 수 있습니다. 인당 1회.
2. API 연결 패널을 엽니다. SillyTavern에서 상단의 플러그 아이콘을 클릭하여 API Connections를 엽니다.
3. API 유형을 선택하세요. API 드롭다운에서 Chat Completion을 선택하세요. 텍스트 완성 모드는 원본 프롬프트를 받는 백엔드를 위한 것입니다. 이 API는 채팅 메시지를 사용합니다.
4. 소스를 선택하세요. Chat Completion Source 목록에서 Custom (OpenAI 호환)을 선택하세요.
5. 엔드포인트를 입력하세요. https://api.deepseekapikey.com/v1을 사용자 정의 엔드포인트 필드에 붙여넣으세요. SillyTavern은 채팅 완성 경로를 자체적으로 추가하므로 경로는 비워두세요. 나중에 404 오류가 발생하면 전체 경로를 두 번째 시도로 시도해 보세요.
6. 키를 입력합니다. 키를 사용자 정의 API 키 필드에 붙여넣습니다.
7. 모델을 입력합니다. 모델 ID 필드에 uncensored을 입력합니다. GET /v1/models 엔드포인트에서 모델 드롭다운이 로드되는 경우 해당 목록에서 선택할 수 있습니다.
8. 연결합니다. Connect를 누릅니다. 녹색 상태 및 모델 이름이 표시되면 호출이 성공했음을 의미합니다. 캐릭터에게 메시지를 보내서 확인하세요.

연결이 실패하면 터미널에서 SillyTavern 외부에서 테스트하세요. 이렇게 하면 문제가 분리됩니다:

Copycurl https://api.deepseekapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Reply with the word ready."}], "max_tokens": 10}'

정상적인 JSON 응답은 키와 URL이 유효하며 문제가 SillyTavern 필드에 있음을 의미합니다. 퀵스타트 가이드에는 더 많은 예시가 나열되어 있습니다.

컨텍스트 크기 및 응답 길이

역할극 설정이 잘 작동하는지 아니면 돈을 낭비하는지는 여기서 결정됩니다. 모델은 프롬프트와 응답을 합쳐서 100,000 토큰의 컨텍스트 창을 지원합니다. SillyTavern에는 샘플링 설정에 자체 컨텍스트 크기 슬라이더가 있어 각 요청에 이력과 캐릭터 데이터를 얼마나 많이 포함할지 제어합니다.

최대 100,000으로 설정할 수 있지만 그 의미를 고려해야 합니다. SillyTavern은 매 턴마다 전체 프롬프트를 구성합니다: 시스템 프롬프트, 캐릭터 카드, 로어북 항목, 페르소나, 그리고 들어맞는 만큼의 채팅 이력. 더 높은 설정은 모델이 과거의 더 많은 내용을 보게 하며, 그 토큰 전부에 대해 메시지마다 다시 비용을 지불합니다.

선택하는 실용적인 방법:

• 8,000~16,000 토큰: 짧은 장면과 빠른 채팅. 저렴하고 빠릅니다.
• 30,000~50,000 토큰: 상세한 캐릭터 카드와 로어북이 있는 긴 이야기. 대부분의 사용자에게 적합합니다.
• 최대 100,000 토큰: 큰 로어북 또는 매우 긴 연속적인 이야기. 프롬프트와 응답의 합계가 창을 넘지 않도록 여유 공간을 두세요.

응답 길이의 경우 일반적인 역할극 응답을 위해 최대 응답 길이를 300~600 토큰으로 설정하세요. API에서 max_tokens 매개변수는 선택 사항이지만 SillyTavern은 값을 전송하며, 이 제한은 응답이 너무 길어져 요금이 폭주하는 것을 방지합니다. 텍스트가 생성되는 대로 표시되도록 스트리밍 옵션을 켜세요. API는 stream: true를 사용하여 서버 전송 이벤트를 지원합니다.

패널티와 샘플링 값 전달은 인터페이스가 제안하는 대로 작동합니다. Temperature, Top P, frequency penalty, presence penalty가 모델에 전달되며, 정지 시퀀스와 고정 시드도 함께 전달됩니다. Temperature는 약 0.8로 시작하고 조정하세요: 캐릭터가 사실 관계를 잃으면 낮게, 답변이 반복적으로 느껴지면 높게 조정하세요.

역할극 비용

가격은 입력 100만 토큰당 $0.15, 출력 100만 토큰당 $0.50입니다. 이력이 다시 전송되므로 입력이 주를 이룹니다. 각 응답이 400 토큰인 계산 예시:

한 행을 확인하세요: 20,000 / 1,000,000 x $0.15 = $0.003, 그리고 400 / 1,000,000 x $0.50 = $0.0002, 총합 $0.0032입니다. 이 크기에서 $0.50의 무료 체험 크레딧은 약 156개의 메시지를 커버할 수 있습니다. 실패하거나 거부된 요청은 요금이 부과되지 않으므로 오류 후 재시도는 청구 금액에 추가되지 않습니다. 스와이프와 재생성은 각각 새로운 완료된 요청이므로 요금이 부과됩니다.

크레딧은 선불 크레딧이며, 만료되지 않으며 구독이 없습니다. $20부터 $500까지의 전체 금액을 충전할 수 있으며, $50부터 +5%, $100부터 +10%, $200부터 +15%의 보너스를 제공합니다. 예를 들어 $100을 충전하면 $110 크레딧이 지급됩니다. 암호화폐(TRC20의 USDT, Base의 USDC)로 결제할 수 있습니다. 요금 페이지에 현재 목록이 있습니다.

그룹 채팅, 스와이프 및 속도 제한

SillyTavern은 여러 요청을 연속으로 보낼 수 있습니다: 여러 캐릭터가 순차적으로 응답하는 그룹 채팅, 스와이프, 내용을 요약하거나 사이드 콘텐츠를 생성하는 확장 기능 등. 전체 키는 동시 요청 8개와 분당 300개의 요청을 허용합니다. 무료 체험 키는 동시 2개, 분당 60개의 요청을 허용합니다.

concurrency 코드와 함께 오류가 발생하면 동시에 너무 많은 요청이 실행 중이었습니다. 다시 시도하기 전에 현재 스트리밍이 완료될 때까지 기다리세요. 스트리밍 요청은 스트리밍이 끝날 때까지 슬롯을 유지하기 때문입니다. rate_limited 코드와 함께 오류가 발생하면 분당 요청 수가 너무 많습니다. Retry-After: 5 헤더와 함께 429 오류는 일시적인 과부하이며 빠르게 해결됩니다.

긴 이야기를 작성할 때는 요약을 위한 확장 기능이나 로어북 항목을 활용하여 사실을 이어가세요. 이렇게 하면 컨텍스트 크기를 낮게 유지할 수 있습니다. 프롬프트 상단에 이전 사건에 대한 짧은 요약을 추가하면, 원본 기록 5만 토큰을 유지하는 것보다 훨씬 적은 비용이 듭니다.

일반적인 문제 해결

연결 시 인증되지 않음 오류 발생

API 키가 잘못되었거나 끝에 공백이 있거나, 다른 서비스에서 발급된 키입니다. DeepSeek 플랫폼에서 발급한 키는 이 Base URL에서는 작동하지 않습니다.

연결 시 페이지 없음 오류 발생

엔드포인트 철자를 확인하세요. 일반적인 설정에서는 /v1로 끝나야 합니다. 일부 빌드에서는 전체 채팅 완료 경로를 요구하므로, 짧은 경로가 실패하면 https://api.deepseekapikey.com/v1/chat/completions을 시도해 보세요.

응답이 짧거나 잘려 나옴

최대 응답 길이를 늘리세요. 긴 대화에서만 잘려 나온다면 프롬프트가 컨텍스트 한계에 가까워졌을 수 있습니다. 응답을 위한 여유 공간을 확보하기 위해 컨텍스트 크기를 약간 낮춰 보세요.

캐릭터가 이전 사건을 잊음

컨텍스트 설정이 적용된 결과입니다. 컨텍스트 크기를 높이거나, 주요 사실을 캐릭터 카드, 페르소나 또는 로어북 항목으로 이동시켜 모든 프롬프트에 유지되도록 하세요.

응답이 거부됨

이 모델은 합법적인 성인용 콘텐츠에 대한 거부 반응을 피하도록 튜닝되었지만, 한 가지 규칙은 변하지 않습니다: 미성년자가 관련된 성 콘텐츠는 금지됩니다. 해당 영역의 캐릭터와 시나리오는 거부됩니다. 이 서비스는 텍스트 전용이므로, SillyTavern에서 이미지 생성을 사용하려면 다른 백엔드가 필요합니다.

API를 통해 전송된 프롬프트는 학습에 사용되지 않습니다. 채팅 파일은 이동하지 않는 한 컴퓨터의 SillyTavern 데이터 폴더에 그대로 유지됩니다. 이 서비스가 DeepSeek 자체 서비스와 어떻게 다른지에 대한 배경 지식을 원하시면 DeepSeek API: 흔한 오해를 참조하세요.

더 많은 가이드

• Janitor AI에서 DeepSeek API 키: API를 사용한 설정
• VS Code에서 DeepSeek API 키: API를 사용한 설정
• DeepSeek API: 무검열 접근을 위한 흔한 오해와 사실