SillyTavern

O SillyTavern pode usar a SpicyAPI de duas maneiras. A primeira é a conexão de chat normal: o SillyTavern envia suas mensagens a um modelo de chat da SpicyAPI pela fonte Custom (OpenAI-compatible). A segunda é a extensão da SpicyAPI, que adiciona os comandos /spicy-img e /spicy-video e um botão Animate, para você criar imagens e vídeos curtos sem sair do chat.

Você pode usar só uma das duas. Ambas usam a mesma conta, o mesmo saldo e os mesmos preços do resto da SpicyAPI, e você paga apenas pelo que executa. A extensão é gratuita e de código aberto (MIT) em github.com/spicyapi-ai/sillytavern-spicyapi.

Antes de começar

• SillyTavern 1.19.0 ou mais recente. Os passos desta página foram conferidos na versão 1.19.0 em 06/10/2026. Os nomes dos menus podem mudar em outras versões.
• git na máquina que roda o SillyTavern, apenas se você quiser a extensão. O SillyTavern o usa para baixar extensões.
• Uma chave de API. As chaves começam com sk-spicy-. Veja Autenticação para as restrições que você pode aplicar a uma chave e Prepare sua conta se ainda não tem conta.
• Saldo. Cada requisição é paga com o seu saldo pré-pago em dólares americanos. Veja Cobrança.

Conecte o chat do SillyTavern à SpicyAPI

Quem envia a requisição de chat é o servidor do SillyTavern, não o seu navegador, então você não precisa configurar mais nada do seu lado.

Escolha um modelo de chat

Os modelos de chat têm ids terminados em /chat. A lista suspensa Available Models é preenchida com a lista completa de modelos da SpicyAPI, então ela também mostra modelos de imagem, vídeo e áudio, que não conversam. Os modelos de chat vêm primeiro: escolha um no topo da lista ou digite ou cole um id /chat em Enter a Model ID.

Para ver todos os modelos de chat e o que cada um aceita, navegue pelos modelos de chat no site ou chame GET https://api.spicyapi.ai/v1/models com a sua chave (veja Catálogo de modelos e schemas). Cada entrada de chat traz context_length, max_output_tokens e supported_parameters.

Para roleplay, o ranking de roleplay classifica os modelos de chat por consistência de personagem e liberdade ao escrever. Alguns modelos de chat não têm censura e outros filtram conteúdo; o catálogo indica a faixa de política de cada modelo.

Configurações recomendadas

Configurações de amostragem que o modelo escolhido não suporta, como temperature, top P, frequency penalty e presence penalty, são ignoradas em vez de rejeitadas. A SpicyAPI lista as que ignorou no cabeçalho de resposta X-Spicy-Ignored-Params. Você pode deixar os controles deslizantes do SillyTavern como estão.

Esforço de raciocínio

A lista Reasoning Effort do SillyTavern não é enviada aos modelos da SpicyAPI. Se quiser defini-lo, adicione você mesmo e apenas para um modelo cujo supported_parameters inclua reasoning_effort:

1. Clique em Additional Parameters, abaixo do botão Connect.
2. Em Include Body Parameters, adicione uma linha, por exemplo:

reasoning_effort: low

Os valores permitidos variam por modelo. Um nível que o modelo não oferece é trocado pelo mais próximo que ele oferece (citado no cabeçalho de resposta X-Spicy-Adjusted-Params), e em um modelo sem níveis de raciocínio a linha é ignorada. Confira antes a entrada do modelo na lista de modelos. Se a resposta vier vazia ou cortada, aumente Response (tokens) ou reduza o esforço.

Imagens no chat

Com Send inline media ativado, o SillyTavern anexa as imagens do chat a todas as requisições seguintes. Um modelo que não lê imagens rejeita a requisição com 400 e, como a imagem continua no chat, todas as mensagens seguintes também falham. Desative Send inline media para modelos só de texto ou oculte a mensagem que contém a imagem.

Vídeos no chat não são enviados ao modelo.

Configurações que um modelo rejeita

Algumas configurações continuam sendo rejeitadas quando o modelo não as suporta, porque mudam a resposta em vez de apenas ajustá-la: Multiple swipes per generation acima de 1 (n), predefinições de Logit Bias e Request token probabilities. Se uma requisição falhar com uma mensagem que cita uma dessas opções, desative-a. O texto do erro informa o campo.

Custom Stopping Strings funcionam em todos os modelos. Um modelo sem sequências de parada (os modelos Grok, por exemplo) as ignora, e um modelo que aceita menos do que você definiu mantém as primeiras; os cabeçalhos de resposta X-Spicy-Ignored-Params e X-Spicy-Adjusted-Params dizem quais. Um valor de controle deslizante fora da faixa do modelo, como temperature 1,5 em um modelo que vai até 1, é reduzido ao limite da mesma forma.

A extensão da SpicyAPI

A extensão cria imagens e vídeos curtos de dentro de um chat. Instale uma vez, adicione sua chave e escolha os modelos.

Comandos

Argumentos nomeados que você pode adicionar aos comandos:

• model=<id> usa um modelo apenas nesta execução. Pressione Tab depois de model= para ver a lista.
• edit=true abre o editor de prompt mesmo quando você digitou um prompt.
• quiet=true salva o resultado e retorna o caminho dele sem publicá-lo, para Quick Replies e STscript.
• avatar=true ou avatar=false (somente imagens) sobrepõe a configuração "usar o avatar do personagem".

/spicy-img a lighthouse on a cliff at dusk, wide shot
/spicy-video waves rolling onto a beach at sunrise
/spicy-video image=last slow push-in, hair moving in the wind

O menu da varinha ao lado do campo de chat tem SpicyAPI picture, SpicyAPI video e SpicyAPI: animate last picture.

Animate

Toda imagem no chat tem um ícone de claquete entre os controles, e as mensagens com imagem têm o mesmo ícone no menu .... Ele transforma aquela imagem em um clipe de vídeo com o seu modelo de imagem para vídeo e adiciona o clipe à mesma mensagem.

Prompts

Se você não der um prompt, o modelo de chat ao qual você está conectado escreve um a partir da cena atual. Com Let me read and edit the prompt before generating ativado (o padrão), abre-se uma janela mostrando o modelo, o preço exato e o prompt como foi escrito. Você pode esperar, digitar o seu ou pressionar Write from the scene de novo. A extensão não inclui prompts, presets nem estilos; as palavras vêm de você ou do seu modelo de chat.

Com modelos que aceitam uma imagem de referência, você pode usar o avatar do personagem para que a imagem se pareça com ele.

Deixe a IA mostrar imagens

Desativado por padrão. Ative em Let the AI show pictures no painel da SpicyAPI e escolha como o modelo de chat pede uma imagem. Você pode usar qualquer uma das duas formas, ou ambas:

As imagens automáticas têm limites próprios, além dos de cada execução abaixo:

• no máximo uma imagem a cada poucas respostas por chat (3 por padrão), e uma solicitação recusada ou que falhou também inicia a espera;
• um limite diário para imagens automáticas neste navegador ($0.50 por padrão);
• acima do seu valor de confirmação, ou Ask me first (o padrão, mostrando a descrição e o preço) ou Skip the picture.

As execuções automáticas só criam imagens, nunca vídeos, e as imagens ficam ocultas da IA como qualquer outro resultado. Enquanto a ferramenta está ativada, sua definição é enviada a cada solicitação de chat, o que custa alguns tokens na sua API de chat. O comportamento completo está no README da extensão.

Preços e limites

Antes de cada execução, a extensão pede uma cotação à SpicyAPI e a mostra em dólares americanos. As cotações são gratuitas.

O painel também mostra quanto esta sessão do navegador gastou. Para um limite rígido que vale em qualquer lugar, defina um limite de gasto diário na própria chave. Veja Autenticação.

Uma execução continua na SpicyAPI se você pressionar Stop waiting ou fechar a página, e é cobrada se der certo. Recupere-a depois com /spicy-task <task id>. Execuções que falham não são cobradas, exceto nos poucos modelos cuja página informa que requisições recusadas são cobradas. Veja Cobrança.

Onde ficam sua chave e seus arquivos

• Sua chave fica em texto simples no arquivo de configurações do SillyTavern, na máquina que o executa (data/<user>/settings.json, em extension_settings.spicyapi). Outras extensões do SillyTavern podem lê-la. Se você usar Connect chat, a chave também é salva no arquivo de segredos do SillyTavern como a chave do endpoint Custom. Por isso vale a pena ter uma chave separada, com limite de gasto.
• Os resultados são baixados e salvos na pasta de imagens do SillyTavern (data/<user>/user/images/<character>/spicyapi_<task id>.png ou .mp4) e depois anexados ao chat. Por padrão, os novos resultados ficam ocultos da IA, para que a próxima requisição de chat não envie uma imagem a um modelo que não consegue lê-la. Ative Let the AI see generated pictures and videos para mudar isso.
• O que sai da sua máquina: o prompt, as configurações do modelo e qualquer imagem de referência vão para api.spicyapi.ai. Quando o seu modelo de chat escreve o prompt, o contexto do chat vai para a API de chat à qual o SillyTavern está conectado, como em qualquer outra mensagem.
• A SpicyAPI guarda os arquivos gerados por tempo limitado. Veja Retenção e destruição.

Se você trocar de chat enquanto algo está sendo gerado, o resultado é salvo, mas não é adicionado ao chat, e a extensão informa onde ele está.

Rota de conexão

Por padrão, a extensão se comunica com https://api.spicyapi.ai diretamente do seu navegador. Se a sua rede ou o navegador bloquear isso, abra Connection no painel e escolha Auto (tenta direto e depois recorre ao proxy CORS do SillyTavern) ou Through SillyTavern's CORS proxy.

O proxy vem desativado. Ative-o definindo enableCorsProxy: true no config.yaml do SillyTavern (ou iniciando o SillyTavern com --corsProxy) e reinicie. Ele não pode ser combinado com a autenticação básica do SillyTavern (basicAuthMode), que rejeita requisições com chave de API. Nesse caso, use a rota direta.

Solução de problemas

Os erros da SpicyAPI terminam com um request_id ou um ID de tarefa. Informe-o ao suporte para que a requisição seja localizada com exatidão. Os códigos de erro estão explicados em Erros.