SillyTavern em português: como conectar com uma chave de API

Antes de abrir o SillyTavern

O SillyTavern é um aplicativo gratuito e de código aberto que você roda no computador (ou no celular Android, pelo Termux) e usa pelo navegador. Ele não traz modelo nenhum: guarda personagens, personas e prompts e manda tudo para a API que você conectar. Por isso a primeira tela pede uma conexão antes de qualquer conversa. Se ainda não instalou, siga a documentação oficial do projeto; o guia para iniciantes, em inglês, explica as peças principais.

Do lado do UnsavedAI, você precisa de uma conta e de uma chave. Gere a chave em /setup e copie a URL base e a chave na aba Your keys. Um aviso honesto: essas páginas estão em inglês, como todo o menu do site. Crie uma chave só para o SillyTavern; assim dá para revogá-la sem mexer nos outros apps.

Conectando, campo por campo

• Abra API Connections (o ícone de tomada).
• Em API, escolha Chat Completion. Text Completion é outro tipo de conexão e não serve aqui.
• Em Chat Completion Source, escolha Custom (OpenAI-compatible).
• Em Custom Endpoint (Base URL), cole a URL base terminada em /v1, sem nada depois. Quem vem do JanitorAI costuma colar o endereço inteiro terminado em /chat/completions; no SillyTavern isso duplica o caminho e dá erro.
• Cole a chave em Custom API Key e clique em Connect.
• Escolha o modelo em Available Models ou digite o ID exato: gemma-4-12b (todos os planos) ou gemma-4-31b (Priority).

Mande um “oi” curto para um personagem simples antes de abrir um chat longo. Se algo falhar, a janela do terminal onde o SillyTavern está rodando costuma mostrar um erro mais claro que a página. O passo a passo com cada rótulo também está no guia do SillyTavern, em inglês.

Três ajustes que evitam dor de cabeça

• Context Size: 56.000. Acima disso, o pedido falha quando a conversa enche.
• Max Response Length: 700 para o gemma-4-12b, 800 para o gemma-4-31b. O padrão de 300 corta respostas no meio da frase.
• Temperature 0,9 e Top P 0,95, com o resto neutro.

O atalho é o preset de SillyTavern que fica na página Setup. Importe em AI Response Configuration (o ícone de controles deslizantes) e ele preenche fonte, URL, modelo, contexto e tamanho de resposta de uma vez, sem mexer nos seus prompts. O preset nunca leva chave; cole a sua depois. Deixe também desligado o envio de imagens: os modelos são só de texto.

Fazendo o modelo responder em português do Brasil

O modelo responde na língua das suas mensagens, então escrever em português já resolve quase tudo. Os cartões de personagem, porém, costumam vir em inglês, e uma primeira mensagem em inglês às vezes puxa as primeiras respostas para o inglês. Três jeitos de travar o idioma, do mais simples ao mais firme:

• Uma linha fora da história no primeiro turno: “(OOC: responda sempre em português do Brasil, informal)”.
• Uma frase no fim da descrição do personagem ou da sua Persona: “Fala português brasileiro, com gírias leves”. Vale para todos os chats com aquele cartão.
• Traduzir a primeira mensagem do cartão. Como ela abre a cena, uma saudação em português faz a conversa começar em português desde a primeira linha.

Sem indicação, o modelo às vezes solta formas de Portugal, como “estás” ou “autocarro”; dizer “português do Brasil” uma vez costuma bastar. Quer trocar também o idioma dos menus do próprio SillyTavern? Procure a opção de idioma da interface nas configurações de usuário; o que aparece traduzido depende da versão instalada.

Quer sentir como o modelo escreve em português antes de configurar tudo? Converse direto no navegador com Renata Ishikawa, dona de um bar meio izakaya, meio boteco na Liberdade, ou com Inácio, o desconhecido de linho branco do festival de Parintins. É o mesmo Gemma 4 12B que a sua chave usa no plano grátis.

Quando aparece um erro

As mensagens de erro do UnsavedAI dizem o que está errado. As mais comuns no SillyTavern:

Se não souber se o problema é a chave ou o SillyTavern, rode primeiro o testador de chave da página Setup. Para casos mais raros, veja conexão falhou no SillyTavern e erro 401, ambos em inglês. O tráfego da API nunca é armazenado, e ninguém lê nem filtra as suas conversas.

Perguntas frequentes