PT ▾

Configuração da API do SillyTavern: configurar API compatível com OpenAI

As configurações da API do SillyTavern são rápidas de configurar se você tiver quatro valores prontos: origem, URL base, chave e nome do modelo. Aqui está o que inserir, como escolher o tamanho do contexto e da resposta, e o que ajuda em caso de erros.

IA sem censura: API LLM vs. Modelos locais vs. Serviços em nuvem

Atualizado em

Palco de teatro com máscaras e balões de diálogo brilhantes que levam a um plugue: conecte o SillyTavern a uma API

Pontos importantes

  • Serão inseridos uma origem compatível com OpenAI, a URL base, a chave de API e o nome do modelo uncensored.
  • O tamanho do contexto no cliente deve ser compatível com a janela de 100.000 tokens da API e com seu orçamento.
  • Fontes comuns de erro são uma URL base incorreta ou um erro de digitação na chave.
  • O roleplay custa frações de centavo por mensagem, pois o histórico é enviado a cada vez.

Os quatro valores que você precisa

O SillyTavern é um frontend para chats e roleplays com cartas de personagens. Ele pode se conectar a várias fontes de texto, incluindo endpoints que usam o formato OpenAI. Para a conexão, você precisa exatamente de quatro informações:

  • Origem: uma origem de chat-completion compatível com OpenAI ou personalizada
  • URL base: https://api.unzensiertesllm.com/v1
  • Chave de API: sua chave obtida na página Obter chave de API
  • Nome do modelo: uncensored

Os nomes dos menus e campos podem variar entre versões do SillyTavern. Baseie-se nos termos acima e, em caso de divergência, consulte a documentação do próprio SillyTavern.

Conexão passo a passo

  1. Entre na nossa plataforma (Google ou e-mail com senha) e gere a chave. Após o login, você obtém $0,50 de crédito de teste com um clique: uma vez por pessoa, válido por 7 dias, sem necessidade de dados de pagamento.
  2. No SillyTavern, abra a seção de conexões de API.
  3. Selecione como tipo de API a variante de chat-completion e como origem a entrada personalizada compatível com OpenAI (os nomes exatos dependem da sua versão).
  4. Insira a URL base com o sufixo /v1.
  5. Insira a chave sem espaços no início ou no final.
  6. Informe o modelo uncensored ou selecione-o na lista, caso o cliente consulte os modelos.
  7. Conecte-se e envie uma mensagem de teste curta.

Se o cliente mostrar uma lista de modelos, ele executa GET /v1/models. Se uncensored aparecer lá, o endereço e a chave estão corretos.

Verificar conexão fora do SillyTavern

Se algo não funcionar, verifique o endereço e a chave separadamente do cliente. Isso evita adivinhações.

curl https://api.unzensiertesllm.com/v1/models \
  -H "Authorization: Bearer DEIN_SCHLUESSEL"

curl https://api.unzensiertesllm.com/v1/chat/completions \
  -H "Authorization: Bearer DEIN_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Sag kurz Hallo."}], "max_tokens": 30}'

Se o curl responder, o problema está no cliente. Se o curl não responder, o problema está na chave, no endereço ou na rede. O saldo restante aparece no cabeçalho de resposta X-Balance-USD.

Escolher corretamente o tamanho do contexto e o comprimento da resposta

Dois controles determinam quanto é enviado e gerado por mensagem:

  • Tamanho do contexto (Context Size): Quantos tokens de histórico, descrição de personagem e informações do mundo são enviados juntos. A API permite até 100.000 tokens para prompt e resposta combinados. Você não precisa usar o limite máximo. Para muitos roleplays, algumas milhares de tokens bastam, e cada token de contexto custa a cada mensagem.
  • Comprimento da resposta (Response Length): Corresponde a max_tokens. A especificação é opcional na API; no cliente, defina-a para evitar que as respostas fiquem excessivamente longas.

Uma regra prática: escolha o tamanho do contexto de modo que a carta de personagem, anotações importantes e as últimas doze mensagens caibam. Tudo mais antigo pode ser descartado pelo cliente ou resumido.

Valores do sampler

A API repassa temperature, top_p, stop, seed e os parâmetros de penalidade. Comece com valores moderados, como temperatura em torno de 0,8, e altere apenas uma configuração por vez. Outros samplers que o SillyTavern oferece para certas fontes podem não ser suportados por esta interface; eles permanecem sem efeito. Verifique isso na documentação.

Quanto custa uma sessão de roleplay

Preços: $0,15 por 1M de tokens de entrada, $0,50 por 1M de tokens de saída. Supondo que cada mensagem envie 8.000 tokens de contexto e receba 350 tokens de resposta:

  • Entrada: 8.000 / 1.000.000 × $0,15 = $0,0012
  • Saída: 350 / 1.000.000 × $0,50 = $0,000175
  • Total: $0,001375 por mensagem

Uma sessão com 200 mensagens custa $0,275. O crédito de teste de $0,50 é suficiente para cerca de 363 mensagens assim (0,50 / 0,001375 ≈ 363,6). Ao duplicar o contexto para 16.000 tokens, a parte de entrada sobe para $0,0024 e a mensagem para $0,002575.

Você pode recarregar qualquer montante inteiro de $20 a $500 com USDT na TRC20 ou USDC na Base. A partir de $50 há +5 % de bônus, a partir de $100 +10 %, a partir de $200 +15 %. O crédito nunca expira. A tabela está na página de preços.

Erros típicos e suas soluções

Mensagem ou sintomaCausaSolução
401 ou erro de autenticaçãoChave incorreta, cortada ou com espaçosInserir novamente, verificar com curl
404 ou modelo não encontrado/v1 ausente ou nome do modelo incorretoInsira a URL base com /v1, modelo uncensored
429 com concurrencyMuitas requisições simultâneas (chave de teste: 2, chave completa: 8)Grupos de chat em sequência em vez de paralelo, fechar abas de streaming
429 com rate_limitedMuitas requisições por minuto (60 ou 300)Não acione a regeneração em rápida sucessão
429 com Retry-After: 5Sobrecarga temporáriaAguarde 5 segundos e envie novamente
Resposta interrompida no meio da fraseComprimento da resposta muito baixo no clienteAumentar o comprimento da resposta
Erro devido ao contexto muito longoO histórico sozinho não cabe na janela de contexto de 100.000 tokens (a resposta é limitada ao espaço restante)Reduza o tamanho do contexto no cliente, encurte mensagens antigas

Uma chamada em streaming ocupa seu espaço no limite de requisições simultâneas até que o stream termine. Isso explica alguns avisos 429 surpreendentes quando você tem vários chats abertos.

Notas sobre conteúdo e privacidade

O modelo é ajustado para atender ficção, roleplay e cenários para adultos sem recusa de conteúdo. Trata-se de um único modelo de pesos abertos de um fornecedor independente, não da API oficial de um grande fabricante. Conteúdo sexual envolvendo menores de idade é excluído sem exceção. A API fornece apenas texto; imagens ou voz não são geradas. Os prompts não são usados para treinamento.

Mais informações sobre a seleção de modelos sem censura estão na comparação de IA sem censura.

Mais guias

Perguntas frequentes

Qual URL base insiro no SillyTavern?

https://api.unzensiertesllm.com/v1, com o sufixo /v1. Para o modelo, informe uncensored.

Qual tamanho de contexto é adequado?

A API permite até 100.000 tokens para prompt e resposta. Para roleplay, algumas milhares de tokens costumam ser suficientes; valores maiores aumentam o custo por mensagem.

Por que recebo um erro 429?

O código de erro indica a causa: rate_limited significa muitas requisições por minuto, concurrency significa muitas simultâneas. Com a chave de teste, valem 60 por minuto e 2 simultâneas.

Quanto custa uma sessão com 200 mensagens?

Com 8.000 tokens de contexto e 350 tokens de resposta, fica em torno de $0,275. Com mais contexto, o preço aumenta.

Sua chave está a um clique de distância

Crie a conta, copie a chave, ajuste a Base URL. Pronto.

Obter chave de API