API grátis para SillyTavern: crédito de teste e configuração

O que gratuito significa aqui

Se você procura uma API gratuita para SillyTavern, a resposta direta é que ninguém pode rodar um modelo de linguagem grande de graça indefinidamente, e este serviço não pretende o contrário. O que você recebe é um início gratuito. Depois de se registrar com Google ou com e-mail e senha, a página da chave de API tem um botão que resgata $0,50 de crédito de teste. É um resgate por pessoa, válido por 7 dias, e não precisa de método de pagamento.

Esse crédito é uso real, não uma demonstração que para após três mensagens. O SillyTavern fala com a API exatamente como falaria com qualquer backend compatível com OpenAI, usando o modelo uncensored, e cada requisição desconta do saldo a $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída. Quando o trial acabar, você decide se continua. Recargas começam em $20, o crédito nunca expira e não há assinatura para cancelar.

O modelo é um único modelo de pesos abertos executado por um provedor independente e ajustado para responder sem recusas de conteúdo para uso adulto legal. Não é uma API oficial de nenhum fornecedor de modelo, e é apenas texto. As funções de imagem e voz do SillyTavern precisam de seus próprios serviços; este endpoint faz chat.

O que $0,50 compra em um chat do SillyTavern

O SillyTavern reenvia muito texto a cada turno: a descrição do personagem, sua persona, quaisquer entradas de lorebook que acionem, o prompt do sistema e o máximo de histórico de chat que couber na sua configuração de janela de contexto. Então o custo de uma mensagem é principalmente o lado de entrada. Aqui estão dois exemplos práticos com os preços reais.

Cenário	Tokens de entrada	Tokens de saída	Custo por mensagem	Mensagens em $0,50
Chat leve, histórico curto	6.000	250	$0.001025	cerca de 487
Chat longo, lorebook grande	20.000	400	$0.0032	cerca de 156

O cálculo da primeira linha: 6.000 tokens de entrada a $0,15 por 1M é $0,0009, e 250 tokens de saída a $0,50 por 1M é $0,000125. Some-os e você obtém $0,001025. Divida $0,50 por isso e você chega a cerca de 487 mensagens. Para a segunda linha, 20.000 tokens de entrada custam $0,003 e 400 tokens de saída custam $0,0002, então $0,0032 por mensagem e cerca de 156 mensagens.

Escale e os números continuam pequenos. Mil mensagens do tipo leve custam $1,025. Mil do tipo pesado custam $3,20. A lição prática é que o comprimento do histórico direciona sua conta, não o comprimento da resposta. Se uma sessão ficar cara, encurte a janela de contexto em vez das respostas.

Requisições falhas ou recusadas não são cobradas, então um erro de conexão ou uma requisição rejeitada não consome seu saldo. Você pode acompanhar o saldo no cabeçalho de resposta X-Balance-USD se testar com curl, e a página de preços tem os níveis de recarga e bônus.

Conecte o SillyTavern passo a passo

1. Obtenha a chave

Entre na página da chave de API, resgate o crédito de teste e copie a chave. Trate-a como uma senha. Se alguma vez colá-la em uma captura de tela ou um preset compartilhado, substitua-a.

2. Teste o endpoint fora do SillyTavern

Um teste de trinta segundos economiza muitas suposições depois. Se isso retornar uma resposta, a chave e a URL estão corretas:

Copycurl https://api.ttsapihub.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
  }'

3. Preencha o painel de conexão

Abra o ícone de plug (Conexões de API) no SillyTavern. Defina o tipo de API como Chat Completion e a origem de chat completion como Personalizado (compatível com OpenAI). Os nomes do menu mudam um pouco entre versões, mas os três campos são sempre os mesmos:

• Endpoint personalizado (URL Base): https://api.ttsapihub.com/v1
• Chave de API personalizada: a chave que você copiou
• ID do modelo: uncensored

Pressione Conectar. Um status verde significa que o SillyTavern conseguiu alcançar o endpoint. Se você digitar o ID do modelo manualmente e o menu suspenso permanecer vazio, tudo bem; o campo aceita o nome diretamente. Você também pode verificar o que o servidor lista com GET /v1/models.

Configurações que valem a pena alterar imediatamente

Os padrões do SillyTavern são ajustados para outros backends, então algumas mudanças valem a pena imediatamente.

Tamanho do contexto

O modelo tem uma janela de 100.000 tokens, compartilhada entre o prompt e a resposta. Você não precisa usá-la toda. Muitas sessões de roleplay funcionam bem com 16.000 a 32.000 tokens de contexto, e a conta cresce a cada token que você reenvia. Comece com 16.000 e aumente apenas quando o personagem esquecer algo que você se importa.

Comprimento máximo da resposta

Isso define max_tokens. É opcional no lado da API, mas o SillyTavern o envia, e é seu limite para respostas longas. 300 a 500 dá respostas no tamanho de chat. Para cenas de história longas, aumente-o.

Streaming

Ative o streaming. A API envia eventos enviados pelo servidor, o SillyTavern imprime a resposta conforme chega, e você pode parar uma geração ruim cedo. Uma coisa a lembrar: uma requisição em streaming mantém sua vaga de concorrência até o fim do stream, então não deixe uma geração travada rodando enquanto tenta outra.

Amostragem

Temperatura, top_p, sequências de parada, seed e penalidades de repetição são passadas para o modelo. Se o modelo parecer repetitivo, aumente um pouco as penalidades e altere um valor de cada vez. Alterar cinco de uma vez não diz nada.

Limites que você notará em sessões longas

Uma chave completa permite 8 requisições simultâneas e 300 requisições por minuto. Uma chave de trial permite 2 requisições simultâneas e 60 por minuto. Para uma pessoa em um único chat, isso é suficiente. O lugar onde você pode atingir o limite é um chat em grupo, onde o SillyTavern pode gerar respostas de vários personagens em rápida sucessão, ou quando você abre duas abas do navegador e regenera em ambas.

Quando você excede um limite, a API responde com HTTP 429. O código de erro é rate_limited quando você enviou muitas requisições por minuto e concurrency quando muitas estão em execução ao mesmo tempo. Em sobrecarga temporária, você também recebe um 429 com um cabeçalho Retry-After: 5. Em todos os casos, a solução é a mesma: aguarde alguns segundos e pressione regenerar. Nada é cobrado pela tentativa falha.

O corpo da requisição pode ter até 8 MB, o que está muito além do que um prompt de chat precisa, mesmo com uma janela de contexto de 100.000 tokens.

Solução de problemas de uma conexão que não funciona

Sintoma	Causa provável	Correção
O status permanece vermelho após Connect	URL base digitada errada, ou o caminho anexado duas vezes	Use exatamente a URL base acima, terminando em /v1, sem /chat/completions no final
401 Não Autorizado	Chave faltando, truncada ou colada com um espaço	Cole novamente e verifique se há espaços no início ou no final
Modelo não encontrado	Nome do modelo incorreto	Defina o ID do modelo para uncensored em minúsculas
429 após alguns cliques	Concorrência de chave de trial de 2	Aguarde as gerações em execução terminarem, depois tente novamente
A resposta corta no meio da frase	Tamanho máximo de resposta muito baixo	Aumente, ou peça uma continuação

Se nada disso explicar, execute o teste curl da etapa 2 novamente. Quando o curl funciona e o SillyTavern não, o problema está nos campos do SillyTavern. Quando o curl falha também, verifique a chave e sua rede. A documentação do quickstart lista o formato da requisição em detalhes.

Conteúdo, privacidade e um limite rígido

O modelo é ajustado para manter o personagem para ficção e roleplay entre adultos, que é a razão pela qual muitos usuários do SillyTavern procuram um backend como este. É destinado ao uso adulto legal. Uma regra não tem exceções: sem conteúdo sexual envolvendo menores de idade, em qualquer enquadramento, e requisições desse tipo não são algo que o serviço existe para suportar.

Em relação à privacidade, os prompts não são usados para treinamento. Esta é uma declaração sobre este serviço; não cobre o que o próprio SillyTavern armazena na sua máquina, portanto, seus registros de chat e arquivos de personagem permanecem onde você os mantiver.

Quando estiver pronto para ir além do trial, a página de preços mostra as opções de recarga. Qualquer valor inteiro de $20 a $500 funciona, com +5% de crédito a partir de $50, +10% a partir de $100 e +15% a partir de $200. Cartão (Visa, Mastercard, Apple Pay, Google Pay) e cripto (USDT na TRC20, USDC na Base) são ambos aceitos.

Mais guias

• URL Base da API TTS: O que é e o que inserir
• Chave de API TTS em Python: Configuração, streaming e modo JSON
• Checklist da API Elevenlabs: Pipeline TTS sem censura