Chave de API DeepSeek no SillyTavern: Conecte nossa API

Configuração rápida

Para uma configuração de chave de API DeepSeek no SillyTavern, um esclarecimento primeiro. Uma chave emitida pela própria plataforma DeepSeek é para o endpoint da DeepSeek. A chave que você obtém neste site pertence a um serviço separado: uma API independente, compatível com OpenAI, que executa um modelo de pesos abertos, ajustado para responder sem recusas de conteúdo para uso adulto legal. Não é a API oficial da DeepSeek, então use a chave deste site apenas com a URL base deste site.

Os valores a inserir no SillyTavern são:

• Origem: Chat Completion, depois Custom (compatível com OpenAI)
• Endpoint personalizado (URL base): https://api.deepseekapikey.com/v1
• Chave de API: a chave da sua conta
• ID do modelo: uncensored

O SillyTavern é atualizado com frequência e os rótulos do menu podem mudar ligeiramente entre as versões, então corresponda pelo significado se um nome for diferente. O restante desta página percorre cada etapa e as configurações que importam para chats longos de personagens.

Passo a passo na interface

1. Obtenha uma chave. Cadastre-se na página da chave de API com Google ou com e-mail e senha. Novos usuários podem reivindicar $0,50 de crédito de teste com um clique, válido por 7 dias, um por pessoa, sem cartão.
2. Abra o painel de conexão de API. No SillyTavern, clique no ícone de plug na parte superior para abrir as Conexões de API.
3. Selecione o tipo de API. Escolha Chat Completion no menu suspenso da API. Os modos de conclusão de texto são destinados a backends que aceitam prompts brutos; esta API usa mensagens de chat.
4. Selecione a origem. Na lista de Origens de Chat Completion, escolha Custom (compatível com OpenAI).
5. Insira o endpoint. Cole https://api.deepseekapikey.com/v1 no campo de endpoint personalizado. O SillyTavern adiciona o caminho de conclusões de chat por conta própria, então deixe-o de fora. Se você receber um 404 mais tarde, tente o caminho completo como uma segunda tentativa.
6. Insira a chave. Cole a chave no campo de chave de API personalizada.
7. Insira o modelo. Digite uncensored no campo de ID do modelo. Se um menu suspenso de modelos for carregado a partir do endpoint GET /v1/models, você pode escolhê-lo de lá.
8. Conecte. Pressione Conectar. Um status verde e o nome do modelo significam que a chamada foi bem-sucedida. Envie uma mensagem para um personagem para confirmar.

Se a conexão falhar, teste fora do SillyTavern em um terminal. Isso isola o problema:

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}'

Uma resposta JSON normal significa que a chave e a URL são válidas e o problema está nos campos do SillyTavern. O quickstart lista mais exemplos.

Tamanho do contexto e comprimento da resposta

É aqui que as configurações de roleplay funcionam bem ou desperdiçam dinheiro. O modelo tem uma janela de contexto de 100.000 tokens, contando o prompt e a resposta combinados. O SillyTavern tem seu próprio controle deslizante de Tamanho do Contexto nas configurações de amostragem, que controla quanto do histórico e dos dados do personagem ele empacota em cada solicitação.

Você pode definir até 100.000, mas pense no que isso significa. O SillyTavern constrói o prompt completo a cada turno: prompt do sistema, ficha do personagem, entradas do livro de lore, persona, e então todo o histórico de chat que couber. Uma configuração maior significa que o modelo vê mais do passado, e você paga por cada um desses tokens novamente em cada mensagem.

Uma maneira prática de escolher:

• 8.000 a 16.000 tokens: cenas curtas e chats rápidos. Barato e rápido.
• 30.000 a 50.000 tokens: uma história longa com uma ficha de personagem detalhada e livro de lore. Bom para a maioria dos usuários.
• Até 100.000 tokens: livros de lore grandes ou histórias contínuas muito longas. Deixe uma margem para que o prompt mais a resposta fiquem abaixo da janela.

Para o comprimento da resposta, defina o Comprimento Máximo da Resposta para 300 a 600 tokens para uma resposta típica de roleplay. O parâmetro max_tokens é opcional na API, mas o SillyTavern envia um valor, e um limite impede que uma resposta muito longa aumente a conta. Ative a opção de streaming para que o texto apareça conforme é gerado; a API suporta eventos enviados pelo servidor com stream: true.

Passar as penalidades e valores de amostragem funciona conforme sugerido pela interface. Temperature, Top P, penalidade de frequência e penalidade de presença são enviados ao modelo, e sequências de parada e uma semente fixa são passadas também. Comece com temperature em torno de 0,8 e ajuste: diminua se o personagem perder o rastro dos fatos, aumente se as respostas parecerem repetitivas.

Quanto custa o roleplay

O preço é $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída. A entrada domina devido ao histórico reenviado. Exemplos trabalhados, com uma resposta de 400 tokens cada vez:

Verifique uma linha: 20.000 / 1.000.000 x $0,15 = $0,003, e 400 / 1.000.000 x $0,50 = $0,0002, o que resulta em $0,0032. Com esse tamanho, o crédito de teste de $0,50 cobre cerca de 156 mensagens. Requisições falhas ou recusadas não são cobradas, então novas tentativas após um erro não aumentam a conta. Swipes e regenerações contam, porque cada uma é uma nova requisição concluída.

O crédito é pré-pago, nunca expira, e não há assinatura. Recarregue qualquer valor inteiro de $20 a $500, com +5% a partir de $50, +10% a partir de $100 e +15% a partir de $200. Por exemplo, $100 credita $110. Você pode pagar com cripto (USDT na TRC20, USDC na Base). A página de preços tem a lista atual.

Chats em grupo, swipes e limites de taxa

O SillyTavern pode enviar várias solicitações próximas: chats em grupo onde vários personagens respondem em sequência, swipes e extensões que resumem ou geram conteúdo lateral. Uma chave completa permite 8 solicitações simultâneas e 300 solicitações por minuto. Uma chave de teste permite 2 simultâneas e 60 por minuto.

Se você vir um erro com o código concurrency, muitas requisições estavam sendo executadas ao mesmo tempo. Aguarde o streaming atual terminar antes de fazer outro swipe, porque uma requisição em streaming mantém sua vaga de concorrência até o fim. Um erro com o código rate_limited significa muitas requisições por minuto. Um 429 com o cabeçalho Retry-After: 5 é uma sobrecarga temporária que se resolve rapidamente.

Para histórias longas, considere usar a extensão de resumo ou entradas de lorebook para manter os fatos, assim você pode manter o tamanho do contexto menor. Um resumo curto dos eventos anteriores no início do prompt custa muito menos do que manter cinquenta mil tokens de histórico bruto.

Corrigindo problemas comuns

A conexão diz não autorizado

A chave está errada, tem um espaço no final ou vem de outro serviço. Uma chave emitida pela plataforma da DeepSeek não funciona com esta URL base.

A conexão diz não encontrado

Verifique a ortografia do endpoint. Ele deve terminar em /v1 na configuração comum. Algumas versões esperam o caminho completo de chat completions, então se a forma curta falhar, tente https://api.deepseekapikey.com/v1/chat/completions.

As respostas são curtas ou cortadas

Aumente o Comprimento Máximo da Resposta. Se o corte ocorrer apenas em conversas longas, seu prompt pode estar próximo do limite da janela; reduza um pouco o Tamanho do Contexto para que haja espaço para a resposta.

O personagem esquece eventos anteriores

Isso é o ajuste de contexto em ação. Aumente-o ou mova os fatos-chave para a ficha do personagem, persona ou uma entrada de lorebook para que eles permaneçam em cada prompt.

A resposta é rejeitada

O modelo é ajustado para evitar recusas de conteúdo para uso adulto legal, mas uma regra não muda: não há conteúdo sexual envolvendo menores de idade. Personagens e cenários nessa área são recusados. O serviço é apenas de texto, então a geração de imagens no SillyTavern precisa de um backend diferente.

Os prompts enviados pela API não são usados para treinamento. Seus arquivos de conversa permanecem na pasta de dados do SillyTavern na sua máquina, a menos que você os mova. Se quiser saber como este serviço difere do próprio da DeepSeek, consulte DeepSeek API: mitos vs. fatos.

Mais guias

• Chave de API DeepSeek no Janitor AI: configuração com nossa API
• Chave da API DeepSeek no VS Code: Configuração com nossa API
• API DeepSeek: Mitos vs. Fatos para Acesso Sem Censura