Guia de Integração da API do SillyTavern: Conecte o GPTProto e Comece a Jogar RPG

Passo 1: Instale e inicie o SillyTavern

O SillyTavern executa a interface de chat, os cartões de personagem e as configurações de prompt no seu computador. Um modelo conectado gera as respostas. A documentação oficial do projeto o descreve como um frontend gratuito e de código aberto.

Prepare o Node.js LTS, o Git, uma conta GPT Proto com saldo de API disponível e um ID de modelo. A inferência em nuvem através do GPT Proto não exige o download de pesos de modelos ou a execução de um modelo na sua GPU.

Instalação no macOS

Baixe a versão LTS na página de download do Node.js, selecione macOS e use o instalador se preferir uma instalação gráfica.

Escolha a versão LTS atual para o seu sistema operacional.

Abra o Terminal e verifique o Git:

git --version

Instale o Git se necessário e, em seguida, execute:

cd ~
git clone https://github.com/SillyTavern/SillyTavern -b release
cd SillyTavern
bash start.sh

A primeira inicialização instala as dependências. Mantenha o terminal aberto enquanto usa o SillyTavern e abra o endereço local exibido nele caso o navegador não abra automaticamente. Estes comandos seguem as instruções oficiais de instalação para macOS.

A primeira inicialização baixa as dependências necessárias.

Para iniciar novamente mais tarde:

cd ~/SillyTavern
bash start.sh

Instalação no Windows

Instale o Node.js LTS e o Git para Windows. Crie uma pasta como C:\AI, abra-a no Explorador de Arquivos, digite cmd na barra de endereços e pressione Enter. Execute:

git clone https://github.com/SillyTavern/SillyTavern -b release

Abra a pasta SillyTavern baixada e clique duas vezes em Start.bat. Deixe o console aberto enquanto conversa. O guia oficial para Windows recomenda evitar pastas controladas pelo Windows, como Arquivos de Programas, e executar o arquivo de inicialização sem permissões de administrador.

Passo 2: Conecte o SillyTavern ao GPT Proto

Faça login no GPT Proto e abra a página do modelo GLM-5.3. A seção de Uso da API fornece o identificador do modelo e uma entrada para Criar Chave de API. Crie ou selecione sua chave, verifique a taxa atual e prepare saldo suficiente para um pequeno teste.

No SillyTavern, abra Conexões de API, usando o ícone de tomada na barra superior. Insira:

Cole a chave propriamente dita no campo de chave. Não adicione Bearer, aspas ou um cabeçalho HTTP completo nele.

As instruções oficiais de endpoint personalizado especificam uma URL base sem /chat/completions; o SillyTavern adiciona esse sufixo. Para esta conexão, o campo de endpoint deve terminar em /v1.

Se você seguiu anteriormente nosso guia de configuração da API do Janitor AI, verifique esta diferença: a URL de Proxy do Janitor usa o endereço https://gptproto.com/v1/chat/completions completo. Copiar esse endereço completo no campo URL Base do SillyTavern forneceria a entrada incorreta.

Combine a fonte, a URL base, a chave e o ID do modelo com os campos acima.

Clique em Connect e, em seguida, em Test Message. Você também pode enviar Hello a partir da tela de boas-vindas. O passo a passo produziu a resposta mostrada abaixo.

Uma mensagem básica confirma que a conexão pode gerar uma resposta.

Uma lista de Modelos Disponíveis vazia não significa necessariamente que a geração está indisponível. Insira o ID exato manualmente quando a descoberta de modelos estiver indisponível. Para alternar modelos posteriormente, use outro ID de modelo de texto suportado pelo GPT Proto e teste novamente; os recursos do modelo e os parâmetros aceitos podem diferir.

Passo 3: Importe um Cartão de Personagem ou Crie o Seu Próprio

Uma conexão de API funcional fornece o modelo. O cartão de personagem fornece a identidade, a voz e a situação inicial.

Importar um cartão de personagem existente

Abra Characters → Import Character, selecione o arquivo do cartão baixado e escolha o personagem importado para começar a conversar. Você também pode procurar personagens através de Extensions → Download Extensions & Assets.

Para cartões PNG, baixe o arquivo original. Um retrato ou captura de tela normal não contém uma definição de personagem utilizável, a menos que esses dados tenham sido incorporados na imagem. O FAQ oficial explica importações de PNG inválidas, incluindo casos em que salvar ou processar uma imagem remove seus dados incorporados.

Crie Noah Bennett a partir de texto

Escolha Create New Character. Comece com Nome, Descrição e Primeira Mensagem; você pode adicionar campos avançados mais tarde. A Descrição informa ao modelo sobre o personagem. A Primeira Mensagem estabelece a cena de abertura e demonstra o estilo que você deseja. O guia de design de personagem explica ambos os campos.

Use o editor de personagens para a identidade e a cena de abertura da IA.

Defina Name como Noah Bennett. Cole este exemplo original em Description. {{char}} refere-se ao personagem e {{user}} à identidade de usuário que você selecionou.

Você está interpretando {{char}}, Noah Bennett, um homem de 25 anos com físico musculoso, um sorriso fácil e uma personalidade calorosa e afetuosa.

APARÊNCIA
Noah tem 1,88 m de altura, ombros largos, braços fortes, peitoral definido e pernas fortes construídas através de anos de treinamento de força. Ele tem cabelos castanhos escuros levemente bagunçados, olhos cor de avelã calorosos, barba por fazer e uma covinha que aparece quando ele sorri. Suas roupas habituais são camisetas ajustadas, calças de moletom confortáveis e tênis. Sua voz é grave e calorosa, e sua risada é fácil.

PERSONALIDADE
Noah é um doce com uma confiança brincalhona. Ele é atencioso, fisicamente expressivo e se sente confortável demonstrando afeto. Ele gosta de fazer {{user}} sorrir através de provocações gentis, gestos atenciosos e elogios sinceros. Seu charme vem da combinação de seu porte imponente com seu coração surpreendentemente gentil.

Ele tem suas próprias opiniões, amizades, ambições e dias ruins ocasionais. Às vezes, ele esconde o nervosismo atrás de uma piada e fica adoravelmente confuso quando {{user}} o pega sendo sentimental. Ele consegue admitir erros e rir de si mesmo.

HISTÓRICO
Noah trabalha como treinador de força e espera abrir uma pequena academia no bairro. Fora do trabalho, ele gosta de cozinhar, fazer trilhas, comédias românticas terríveis e experimentar receitas de panquecas. Ele leva o treinamento a sério, mas nunca julga as pessoas por seus corpos ou níveis de condicionamento físico.

RELACIONAMENTO COM {{user}}
Noah e {{user}} são vizinhos amigáveis que começaram a passar mais tempo juntos recentemente. Ele se sente atraído por {{user}} e torna seu interesse evidente através de atenção, paquera brincalhona e convites para fazer coisas comuns juntos. Deixe a proximidade deles se desenvolver através de interações reais.

ESTILO DE PAQUERA
Sua paquera é calorosa, específica e levemente atrevida. Ele pode manter contato visual um pouco mais, lembrar de uma bebida favorita ou admitir que encontrou uma desculpa para passar por lá. Ele percebe as respostas de {{user}} e se ajusta naturalmente. O afeto deve parecer bem-vindo e mútuo.

ESTILO DE ROLEPLAY
Mantenha-se no personagem de Noah durante a história. Use diálogos naturais, pequenos gestos físicos e detalhes concretos em vez de longas explicações de personalidade.
Escreva ações entre *asteriscos* e diálogos entre aspas.
Normalmente, responda em um a três parágrafos curtos, deixando espaço para {{user}} participar.
Controle apenas a fala, as ações e os pensamentos de Noah. Deixe o diálogo, as decisões e os sentimentos de {{user}} para o usuário.
Mantenha os detalhes estabelecidos e responda diretamente ao que acabou de acontecer.
Use um idioma natural, a menos que {{user}} solicite outro idioma.

Cole isto em First Message:

*Noah está parado do lado de fora da sua porta com uma bolsa de academia sobre um ombro largo e um pequeno saco de papel na mão. Seu cabelo escuro ainda está levemente úmido, e sua camiseta cinza ajustada traz uma pequena camada de farinha perto da bainha.*

"Antes que você diga qualquer coisa — sim, eu sei cozinhar coisas que não sejam frango com arroz."

*Ele levanta o saco de papel, uma covinha aparecendo enquanto ele sorri.*

"Rolinhos de canela. Fiz demais." *Uma breve pausa.* "Ok, fiz a mais porque estava esperando te ver."

"Então... você está livre para um café?"

Conclua a criação do personagem e, em seguida, selecione Noah. Mantenha as instruções principais na Descrição e a abertura na Primeira Mensagem. As Notas do Criador fornecem metadados para as pessoas que leem o cartão e não são usadas para criar o prompt do modelo.

O cartão do Noah concluído separa sua identidade contínua de sua saudação inicial.

Defina sua própria Persona

Personagens definem a identidade da IA. Personas definem a sua. Abra o Gerenciamento de Persona, crie e selecione uma persona e, opcionalmente, adicione um nome, avatar e descrição, seguindo as instruções oficiais de Persona.

Para esta cena fictícia, uma breve descrição é suficiente:

{{user}} é um adulto que se mudou recentemente para o bairro. Noah e {{user}} são vizinhos amigáveis que estão se conhecendo. {{user}} decide suas próprias falas, ações, escolhas e sentimentos.

Use detalhes fictícios que você deseja que o personagem saiba; você não precisa inserir sua biografia real. Para mais ideias de escrita de personagens, veja como criar seu próprio personagem de IA com uma API.

Passo 4: Inicie sua primeira conversa de Roleplay

Abra o chat do Noah e leia a saudação. Na captura de tela, o usuário responde sim, e Noah responde: “É? Ok. Ótimo.” Ele então continua o convite para o café com ações e diálogos. Essa continuação gerada é a verificação de conexão útil.

Para um prompt mais específico para testar você mesmo, envie:

"Então os pãezinhos de canela eram apenas uma desculpa para me ver?"
*Eu olho para o saco de papel e depois volto a olhar para ele.*

Verifique se a resposta segue a personalidade de Noah, responde à sua última entrada e deixa as decisões por sua conta. Se o estilo precisar de ajustes, edite uma parte do cartão e tente um novo chat. Evite alterar o modelo, o prompt do personagem e várias configurações ao mesmo tempo; você terá menos informações sobre o que ajudou.

Opcional: Adicione Informações de Mundo ao seu personagem

As Informações de Mundo (World Info), também chamadas de lorebook, adicionam informações de cenário ao prompt sob condições configuradas. Para um primeiro experimento, adicione um local da cena do Noah.

Abra World Info, crie um lorebook e adicione uma entrada ativada usando a estratégia de gatilho por palavra-chave. Use estes valores de exemplo:

No painel de personagem do Noah, use Mais… → Vincular World Info, ou o botão de globo de lore do personagem, para associar o lorebook a ele. Em seguida, pergunte: Como é o Corner Cafe?

A documentação de World Info explica que o Conteúdo da entrada é o que entra no prompt; o título sozinho não fornece os fatos. A ativação também depende das configurações e do orçamento disponível, e o modelo pode não usar todos os detalhes fornecidos. Comece com uma entrada concisa e verifique seu comportamento antes de adicionar um mundo grande.

Quanto custa o SillyTavern com o GPT Proto?

O GLM-5.3 é o modelo usado para este passo a passo. Escolha seu modelo de acordo com o orçamento, naturalidade do diálogo, expressão emocional, consistência do personagem e velocidade de resposta. Compare candidatos com o mesmo card e cena de abertura. Para conversas diárias, inclua os custos de contexto retido em seu orçamento; para cenas focadas em história, verifique se a voz parece crível e se o modelo deixa as escolhas por sua conta.

O SillyTavern em si é gratuito. A geração de modelos do GPT Proto utiliza o saldo da sua API. No momento desta guia, o GLM-5.3 está 15% abaixo de suas taxas oficiais de entrada e saída no GPT Proto:

Taxas verificadas em 3 de novembro de 2026. Consulte o painel de preços do GLM-5.3 para ver as taxas atuais e qualquer precificação de cache aplicável.

Uma solicitação ilustrativa com 8.000 tokens de entrada sem cache e 500 tokens de saída faturáveis custa:

(8.000 ÷ 1.000.000 × $1,19) + (500 ÷ 1.000.000 × $3,74)
= $0,01139

Este é um exemplo de cálculo, não a fatura medida para a conversa da captura de tela. A saída faturável não é uma contagem de palavras; use o uso relatado pelo provedor, incluindo quaisquer tokens de raciocínio cobrados como saída.

A entrada pode incluir instruções de personagem, Persona, lore selecionada e histórico de conversa retido. Como explica a visão geral da conexão da API, o SillyTavern reúne esses elementos no prompt. Um contexto retido mais longo pode aumentar o custo de uma resposta, mesmo quando sua mensagem mais recente for apenas sim.

Por que escolher o GPT Proto para sua API do SillyTavern?

O GPT Proto oferece modelos oficiais de provedores com taxas com desconto em modelos selecionados, incluindo o GLM-5.3. Uma chave e um saldo compartilhado cobrem vários provedores. No SillyTavern, mantenha seus cards de personagem e conexão personalizada, mude para outro ID de modelo de chat compatível e compare suas respostas.

Para confiabilidade, os principais modelos usam canais upstream redundantes e failover automático para ajudar a reduzir interrupções quando um canal fica indisponível. Você pode escolher entre modelos com preços e estilos de conversação diferentes enquanto mantém sua configuração.

Antes de uma sessão longa, verifique a disponibilidade do modelo, custos de entrada/saída, velocidade de resposta e tratamento de dados. Comece com um pequeno teste e revise o uso. A página de modelos do SillyTavern permite que você explore opções e compare custos.

Problemas comuns da API do SillyTavern e soluções

Comece com um chat novo e uma mensagem curta. Em seguida, combine o sintoma com a verificação a seguir:

Modelos de raciocínio precisam de atenção especial. O guia oficial de Raciocínio explica que o pensamento pode consumir tokens de resposta, mesmo quando oculto. Um limite muito pequeno para esse modelo pode resultar em uma resposta visível vazia ou inacabada. Verifique o Comprimento Máximo da Resposta em relação aos requisitos do modelo, em vez de aplicar o mesmo limite pequeno a todos os modelos.

Uma discussão da comunidade sobre lorebooks e respostas vazias descreve um usuário que se recuperou após remover uma predefinição e aumentar o limite de resposta. Como ambos foram alterados juntos, o relato não isola uma causa única. Isso reforça uma ordem prática de solução de problemas: faça um chat simples funcionar e, em seguida, adicione predefinições e lore, uma alteração por vez.

Opcional: Teste a API fora do SillyTavern

Com sua chave armazenada de forma privada na variável de ambiente GPTPROTO_API_KEY, este comando de shell para macOS/Linux envia uma solicitação direta usando o formato de Chat Completions da página do modelo:

curl --request POST "https://gptproto.com/v1/chat/completions" \
  --header "Authorization: Bearer $GPTPROTO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "glm-5.3",
    "messages": [
      {"role": "user", "content": "Reply with: API connection works."}
    ]
  }'

Verifique se há uma resposta bem-sucedida contendo texto gerado, não apenas um indicador de conexão. Se isso funcionar enquanto o SillyTavern falha, compare os campos e parâmetros adicionados do cliente. Se ambos falharem, investigue o erro de autenticação, saldo, modelo ou serviço retornado. Mantenha chaves reais fora de postagens públicas de solução de problemas.