PT ▾
Obter chave de API

Configuração da API do SillyTavern: como conectar de forma compatível com OpenAI

Explicamos os pontos confusos da configuração da API do SillyTavern: destino, chave, nome do modelo e valor do contexto, junto com comandos de verificação.

Atualizado em

Pontos-chave

  • Selecione Personalizado (Compatível com OpenAI) em Chat Completion
  • A URL é https://api.mukenetsuapi.com/v1, o nome do modelo é uncensored
  • O contexto suporta até 100.000, mas é mais realista limitar para controlar custos e velocidade
  • Para 401, verifique a chave; para 404, verifique a URL; para 429, suspeite de exceder o limite de requisições simultâneas ou o limite de contagem
Imagem conceitual da conexão API do SillyTavern: uma máscara de palco conectada a um plugue de servidor por um cabo brilhante

Prepare os 3 itens necessários primeiro

A configuração da API do SillyTavern é curta; a maioria dos erros vem de valores incorretos. Tenha os 3 itens abaixo em mãos antes de começar.

  • API key: Página para obter a chave de API para emitir. Após o cadastro, você recebe $0,50 de crédito de teste grátis com um clique.
  • Base URL: https://api.mukenetsuapi.com/v1
  • Nome do modelo: uncensored

O SillyTavern é um front-end que permite adicionar endpoints compatíveis com OpenAI. Como esta API é compatível, não é necessário usar o OpenAI oficial; registre-a como um endpoint personalizado.

Passo a passo da conexão

Os textos do menu podem variar conforme a versão. Aqui descrevemos o fluxo geral. Se for diferente, consulte também a documentação do próprio SillyTavern.

  1. Abra as “API Connections” (ícone de plugue) na parte superior.
  2. Selecione “Chat Completion” como o tipo de API.
  3. Na lista de fontes, escolha a conexão personalizada compatível com OpenAI (Custom).
  4. Insira https://api.mukenetsuapi.com/v1 no URL do endpoint. Não adicione /chat/completions no final.
  5. Cole a chave emitida no campo da chave de API. Certifique-se de que não haja espaços em branco antes ou depois.
  6. Defina o nome do modelo como uncensored. Selecione na lista ou digite manualmente.
  7. Clique no botão de conexão e verifique se aparece uma mensagem de sucesso.

Verifique a chave e a URL no terminal antes de conectar para facilitar a solução de problemas.

curl https://api.mukenetsuapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "こんにちは"}], "max_tokens": 50}'

Se houver resposta, a chave, a URL e o nome do modelo estão corretos. Se o SillyTavern falhar nesse estado, o problema está no input do aplicativo.

Definir contexto e comprimento da resposta

A janela de contexto desta API suporta até 100.000 tokens combinando prompt e saída. Não recomendamos definir o tamanho do contexto do SillyTavern no máximo, pois cada envio reenvia a configuração do personagem, o cenário e o histórico, aumentando o input por vez.

Exemplo de cálculo de custos

Se o contexto for de 16.000 tokens e a resposta tiver 300 tokens, o custo por mensagem é:

  • Input: 16.000 ÷ 1.000.000 × $0,15 = $0,0024
  • Output: 300 ÷ 1.000.000 × $0,50 = $0,00015
  • Total: $0,00255

São $0,255 por 100 mensagens. Se reduzir o contexto pela metade para 8.000, o custo do lado da entrada cai pela metade. Para detalhes do preço unitário, consulte página de preços.

Estimativa

Se não for uma história longa ou uma cena com muitos personagens, comece com 8.000 a 16.000 e aumente se sentir que o personagem está esquecendo eventos passados; essa é a ordem mais prática. Defina o comprimento máximo da resposta de acordo com o tamanho que você deseja ler como uma única resposta. O parâmetro max_tokens é opcional, mas é recomendável definir um limite no lado do SillyTavern se quiser evitar respostas excessivamente longas.

Abordagem das configurações de amostragem

temperature, top_p, stop, seed e as penalidades variadas são passadas diretamente para a API. Você pode ajustá-las usando os presets do SillyTavern.

  • Repetição de frases: aumente ligeiramente as penalidades de frequency ou presence.
  • Resposta dispersa: reduza a temperatura.
  • Monotonia: aumente um pouco a temperatura.
  • Para comparar: fixe o seed e altere os valores um por um.

Os nomes dos campos do preset variam conforme a versão do SillyTavern. Se as configurações não forem aplicadas, verifique na documentação do SillyTavern se o método de conexão que você está usando suporta esses campos.

Erros comuns e soluções

SintomaPossível causaSolução
401Chave incorreta ou com espaçosCole a chave novamente e teste-a usando curl.
404URL incorretaVerifique se termina com /v1.
Modelo não encontradoOrtografia do nome do modeloDigite em minúsculas: uncensored.
429 (concurrency)Muitas requisições simultâneasReduza as batidas rápidas no swipe e a geração simultânea em chats de grupo.
429 (rate_limited)Limite de requisições por minuto excedidoAguarde um pouco.
429 (com Retry-After: 5)Congestionamento temporárioAguarde 5 segundos e tente novamente.

O limite da chave completa é 8 requisições simultâneas e 300 por minuto; a chave de teste é limitada a 2 simultâneas e 60 por minuto. Uma resposta em streaming ocupa 1 slot de concorrência até ser concluída. Se você executar chat em grupo com a chave de teste, os slots se preencherão rapidamente.

Você pode verificar se há saldo suficiente usando o seguinte comando.

curl https://api.mukenetsuapi.com/v1/balance \
  -H "Authorization: Bearer YOUR_API_KEY"

Você também pode ler o saldo no cabeçalho de resposta X-Balance-USD. Para ver a lista de modelos, use GET /v1/models.

curl https://api.mukenetsuapi.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Observações de uso

Esta API é apenas para texto. Para usar recursos de geração de imagem ou áudio do SillyTavern, é necessário outro serviço. O conteúdo assume-se como ficção, como romances, roleplay ou aplicativos de companhia, dentro dos limites legais para adultos. Não será gerado conteúdo sexual envolvendo menores de idade em nenhuma configuração. Os prompts não são usados para treinar o modelo.

Para parâmetros mais detalhados, consulte documentação, e os pagamentos são em USDT (TRC20) ou USDC (Base) em valores inteiros de $20 a $500.

Outros guias

Perguntas frequentes

Qual é o nome do modelo usado no SillyTavern?

É uncensored. Digite-o em minúsculas exatamente como está.

É necessário adicionar /chat/completions ao final da URL?

Não é necessário. O Base URL deve terminar em /v1; o restante do caminho é adicionado pelo aplicativo.

A chave de teste é suficiente?

É suficiente para confirmação de conexão e conversas curtas. No entanto, a chave de teste é limitada a 2 requisições simultâneas e 60 por minuto, com validade de 7 dias; se for usar chat em grupo, recarregue sua chave normal.

É possível gerar imagens?

Não. Esta API é apenas para texto e não oferece suporte à geração de imagens, áudio ou vídeo.

Qual tamanho de contexto devo usar?

O máximo é 100.000 tokens, mas é mais realista começar com 8.000 a 16.000. Quanto maior o contexto, maior será o custo de entrada em cada requisição.

Chave de API obtida com apenas 1 formulário

Crie a conta, copie a chave e altere o Base URL. Com isso, a configuração está completa.

Obter chave de API