Configuração da API do SillyTavern: URL base, chave de API e lista de modelos

Resposta rápida: as cinco configurações que importam

Abra o painel API Connections (o ícone de tomada) e configure exatamente isto: API = Chat Completion. Chat Completion Source = Custom (OpenAI-compatible). Custom Endpoint (Base URL) = https://api.apisrouter.com/v1. Custom API Key = sua chave sk-... . Clique em Connect, espere a luz verde acender e escolha um modelo na lista, por exemplo deepseek-v4-flash. O erro mais comum, de longe, é colar o caminho completo. O SillyTavern acrescenta /chat/completions a tudo que você digitar, então a URL precisa parar em /v1. Se você colar https://api.apisrouter.com/v1/chat/completions, o SillyTavern solicita /v1/chat/completions/chat/completions e a conexão falha com um erro 404. Isso é o oposto do JanitorAI, que exige a URL completa de completions na configuração de proxy. Mesmo provedor, convenções de campo diferentes.

Por que a URL da API do SillyTavern termina em /v1

Toda API compatível com OpenAI é uma URL base mais um conjunto de rotas fixas. GET /v1/models retorna a lista de IDs de modelo que sua chave pode usar. POST /v1/chat/completions executa a requisição de chat propriamente dita. O SillyTavern conhece essas rotas e as monta sozinho, então só pede a base. Ao clicar em Connect, ele chama /v1/models com sua chave e usa a resposta para preencher a lista de modelos. Uma lista vazia quase sempre significa que essa chamada falhou. Você também precisa escolher o modo de API certo. Chat Completion envia mensagens estruturadas com papéis system, user e assistant, o que é o que todo provedor hospedado compatível com OpenAI espera. Text Completion envia uma única string de prompt bruta e existe principalmente para backends locais como KoboldCpp e text-generation-webui. Para qualquer chave de API hospedada, use Chat Completion. Se você selecionar Text Completion contra um endpoint de chat hospedado, vai receber erros ou formatação quebrada, e vários samplers exibidos nesse modo simplesmente não são enviados de qualquer forma.

Configuração passo a passo

Se a lista continuar vazia depois de Connect, revise três coisas nesta ordem: se a URL termina em /v1 sem caminho adicional nem espaços no final, se a chave foi colada sem aspas ou espaços em branco, e se a fonte é Custom (OpenAI-compatible) em vez de OpenAI simples. A fonte OpenAI simples ignora sua URL personalizada em algumas versões e fala com api.openai.com, onde sua chave é inválida.

• Consiga uma chave. Na APIsRouter não existe formulário de cadastro: você paga em /topup e a chave chega por e-mail. Qualquer chave compatível com OpenAI funciona do mesmo jeito nestes passos.
• No SillyTavern, clique no ícone de tomada para abrir API Connections.
• Defina API como Chat Completion.
• Defina Chat Completion Source como Custom (OpenAI-compatible).
• Em Custom Endpoint (Base URL), digite https://api.apisrouter.com/v1 sem nada depois de /v1.
• Cole sua chave no campo Custom API Key.
• Clique em Connect. O indicador de status fica verde e a lista Available Models se preenche a partir de /v1/models.
• Selecione um modelo, abra um character card e envie uma mensagem de teste curta.

Verifique a conexão fora do SillyTavern

Quando algo falha, teste o endpoint diretamente antes de culpar o SillyTavern. Esta chamada curl é exatamente o que o botão Connect faz. Se retornar um array JSON de IDs de modelo, sua chave e sua URL estão corretas e o problema está nos campos do SillyTavern. Se a lista de modelos funciona mas os chats falham, execute uma completion real a partir do Python com a mesma URL base. Uma resposta bem-sucedida aqui prova que toda a cadeia funciona, e qualquer mensagem de erro que você receber é o erro real do provedor, não o genérico do SillyTavern.

curl https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer sk-your-key"

O básico de samplers e presets

Fontes Chat Completion expõem um conjunto pequeno de samplers: temperature, top P, frequency penalty e presence penalty, além do tamanho da resposta e do contexto. Samplers mais sofisticados dos quais você talvez já tenha ouvido falar (min P, mirostat, dynamic temperature) pertencem a backends de Text Completion e simplesmente não são enviados para APIs de chat hospedadas, então não os procure aqui. Presets no SillyTavern combinam duas coisas: valores de sampler e a estrutura de prompt que o Prompt Manager monta a partir do seu character card, persona e lorebook. O preset Default embutido é um ponto de partida razoável. Mude um valor de cada vez e regenere a mesma cena para ver o que ele realmente faz. O tamanho do contexto merece atenção: o SillyTavern preenche a janela de contexto com o histórico do chat, então um contexto maior significa mais tokens de prompt enviados a cada turno, o que melhora a memória e aumenta o custo por mensagem ao mesmo tempo.

Modelos recomendados para o SillyTavern

A escolha do modelo importa mais do que ajustar o sampler. O consenso da comunidade, no que dizem os relatos aproximados, coloca a família DeepSeek V4 em primeiro lugar pelo preço: deepseek-v4-flash é a recomendação padrão para chats longos e deepseek-v4-pro mantém melhor cards complexos e chats em grupo coesos. GLM-5, Kimi K2.6 e MiMo são boas opções de custo-benefício com vozes de prosa distintas, e vale a pena revezar quando um chat começa a parecer repetitivo. O Grok se destaca porque a política publicada da xAI permite explicitamente temas adultos em contextos de ficção, o que importa para tramas mais sombrias. O Claude escreve a melhor prosa de toda esta lista, mas a política da Anthropic proíbe conteúdo explícito, então trate o Claude como a escolha para escrita criativa SFW e cenas em estilo literário. Duas notas práticas. Primeiro, o SillyTavern é software voltado para adultos, e cada modelo aqui aplica a política de conteúdo do seu próprio provedor independente do seu frontend, então mantenha cards e cenas dentro dessas regras. Segundo, como a lista é preenchida ao vivo a partir de /v1/models, você pode trocar de modelo no meio do chat e comparar respostas à mesma mensagem, a forma mais rápida de encontrar seu favorito.

Quanto os chats do SillyTavern realmente custam

Modelos hospedados cobram por token, e o roleplay consome muita entrada: cada turno reenvia o character card mais o histórico recente. Um turno que envia 8.000 tokens de prompt e recebe uma resposta de 350 tokens custa cerca de um décimo de centavo no deepseek-v4-flash, então alguns dólares cobrem meses de conversa casual. O mesmo turno no claude-opus-4-7 custa aproximadamente 25 vezes mais, por isso a maioria roda um modelo barato no dia a dia e guarda os modelos premium para cenas que realmente importam. Uma única chave de gateway cobre toda esta tabela. A APIsRouter é um gateway compatível com OpenAI com faturamento por uso e sem assinatura: você paga em /topup sem criar conta, a chave chega por e-mail, sua primeira recarga soma um +100% adicional ao seu saldo, modelos globais têm preço 20% abaixo das tarifas oficiais, e modelos chineses ficam abaixo de seus preços oficiais.

Perguntas frequentes