Documentação

SillyTavern

A origem Custom (OpenAI-compatible) do SillyTavern precisa de uma URL base e uma chave. Aponte-a para a Kunavo para que Claude e GPT apareçam na mesma lista suspensa de modelos.

Para conectar o SillyTavern à Kunavo, abra API Connections, defina API como Chat Completion e Chat Completion Source como Custom (OpenAI-compatible). Depois, preencha dois campos: Custom Endpoint = https://api.kunavo.com/v1 e Custom API Key = sua chave sk-kn-…. Pressione Connect; o SillyTavern chama GET /v1/models e preenche a lista suspensa de modelos com base na resposta.

Campo do SillyTavern	Valor
API	Conclusão do chat
Origem da conclusão do chat	Personalizado (compatível com OpenAI)
Endpoint personalizado (URL base)	`https://api.kunavo.com/v1`
Chave de API personalizada	`sk-kn-…`
Modelos disponíveis	Preenchido automaticamente após Connect — selecione qualquer id

O sufixo /v1 deve fazer parte deste campo. A origem personalizada do SillyTavern segue a convenção da OpenAI e acrescenta apenas o caminho da rota. Sem /v1 no valor https://api.kunavo.com, a conexão falha e a lista de modelos fica vazia.

Passo a passo

Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
No SillyTavern, abra o ícone do plugue (API Connections) na barra superior.
Defina API → Chat Completion e, em seguida, Chat Completion Source → Custom (OpenAI-compatible).
Cole https://api.kunavo.com/v1 em Custom Endpoint e informe a chave em Custom API Key.
Pressione Connect. Um status verde e uma lista suspensa Available Models preenchida indicam que funcionou.
Selecione um id de modelo na lista suspensa e inicie um chat. Para alternar modelos depois, não é necessário reconectar.

A referência do próprio SillyTavern para esta tela é a página de conexões da API Chat Completions.

Verifique antes de depurar a interface

Uma única solicitação permite determinar se a falha está no endpoint, na chave ou no SillyTavern. Se ela retornar uma lista JSON de ids de modelos, a mesma URL e chave preencherão a lista suspensa.

# Confirms the key and the endpoint before you touch SillyTavern.
# A JSON list of model ids means the same URL will populate the dropdown.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Quais modelos escolher

Todos os modelos de texto da Kunavo podem ser acessados pela mesma lista suspensa — a lista completa está na página de modelos e é retornada em tempo real por GET /v1/models. As tarifas são em USD por 1 milhão de tokens, entrada/saída.

ID do modelo	Entrada / saída da Kunavo	Indicação de uso
`claude-haiku-4-5`	$0.70 / $3.50	Claude mais barato — para sessões longas em que o custo por turno é mais importante
`claude-sonnet-5`	$1.40 / $7.00	O equilíbrio padrão entre qualidade e preço
`claude-opus-5`	$3.50 / $17.50	A categoria Claude de mais alta qualidade
`claude-fable-5`	$7.00 / $35.00	Raciocínio de ponta com janela de contexto de 1 milhão de tokens — a escolha quando o próprio histórico do chat é o problema

Em uma sessão longa do SillyTavern, o comprimento do contexto é a primeira limitação a aparecer: o histórico inteiro é reenviado a cada turno, então o gasto com tokens cresce junto com a conversa, em vez de permanecer estável. A Kunavo cobra por token a partir de um saldo pré-pago, sem mensalidade, então um mês sem uso não custa nada — confira os detalhes em cobrança. Para um contexto que se repete, o cache de prompts é o recurso que mais importa.

Solução de problemas

Sintoma	Causa	Correção
A conexão falha e a lista de modelos continua vazia	Falta `/v1` em Custom Endpoint	Use `https://api.kunavo.com/v1`. Confirme com o comando curl acima.
401 / chave inválida	Chave colada com espaços em branco ou revogada	Copie novamente de `/app/keys`; consulte erros 401 e 403
As respostas chegam todas de uma vez, sem streaming	Um proxy na frente da conexão está armazenando os eventos enviados pelo servidor em buffer	O endpoint oferece suporte a streaming — erros de streaming
Id do modelo rejeitado	O endpoint não disponibiliza esse id	Selecione na lista suspensa ou consulte model_not_found
Erros apenas em chats longos	O histórico ultrapassou a janela de contexto do modelo	Reduza o histórico ou mude para um modelo com contexto mais longo — context_length_exceeded

Duas observações sinceras

Sem afiliação

O SillyTavern é um projeto independente e de código aberto, sem afiliação com a Kunavo. Esta página documenta uma configuração funcional porque o SillyTavern oferece suporte a endpoints arbitrários compatíveis com OpenAI — nada aqui foi adaptado especificamente por nenhum dos dois lados.

A política de conteúdo continua valendo

As solicitações feitas pela Kunavo chegam aos provedores upstream, e cada provedor aplica sua própria política de uso ao conteúdo enviado. Um gateway não elimina esses limites, e qualquer página que diga o contrário está tentando vender algo. Os termos da própria Kunavo estão na política de uso aceitável.

Perguntas frequentes

Como conecto o SillyTavern a um endpoint de API personalizado?

No SillyTavern, abra a guia API Connections (ícone do plugue), defina API como Chat Completion e Chat Completion Source como Custom (OpenAI-compatible). Informe a URL base compatível com OpenAI do gateway em Custom Endpoint — para a Kunavo, é https://api.kunavo.com/v1 —, informe a chave em Custom API Key e pressione Connect. Em seguida, o SillyTavern chama GET /v1/models nesse endpoint e preenche a lista suspensa de modelos com base na resposta.

O SillyTavern funciona com modelos Claude por meio de um endpoint compatível com OpenAI?

Sim. A origem Custom (OpenAI-compatible) do SillyTavern só precisa de um endpoint que implemente POST /v1/chat/completions, então os modelos Claude disponibilizados nesse formato funcionam sem usar a origem Anthropic separada do SillyTavern. Na Kunavo, os ids dos modelos Claude e GPT aparecem na mesma lista suspensa sob uma única chave, e alternar entre eles não exige reconexão.

O streaming funciona no SillyTavern com um endpoint personalizado?

O streaming funciona desde que o endpoint implemente eventos enviados pelo servidor em /v1/chat/completions, como a Kunavo faz. Se as respostas chegarem apenas como um bloco completo, a causa mais comum é um proxy na frente da conexão armazenando os dados do fluxo em buffer, e não o próprio endpoint.

Por que a lista de modelos do SillyTavern fica vazia depois da conexão?

Uma lista suspensa de modelos vazia no SillyTavern significa que a chamada GET /v1/models falhou. O problema está no endpoint ou na chave, não no SillyTavern. As duas causas mais comuns são uma URL base sem o sufixo /v1 e uma chave inválida para esse endpoint. Executar curl em /v1/models usando a mesma chave reproduz a falha fora do SillyTavern e permite identificar qual das duas causas ocorreu.