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.


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
- 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.
- No SillyTavern, abra a seção de conexões de API.
- 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).
- Insira a URL base com o sufixo
/v1. - Insira a chave sem espaços no início ou no final.
- Informe o modelo
uncensoredou selecione-o na lista, caso o cliente consulte os modelos. - 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 sintoma | Causa | Solução |
|---|---|---|
| 401 ou erro de autenticação | Chave incorreta, cortada ou com espaços | Inserir novamente, verificar com curl |
| 404 ou modelo não encontrado | /v1 ausente ou nome do modelo incorreto | Insira a URL base com /v1, modelo uncensored |
429 com concurrency | Muitas 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_limited | Muitas requisições por minuto (60 ou 300) | Não acione a regeneração em rápida sucessão |
429 com Retry-After: 5 | Sobrecarga temporária | Aguarde 5 segundos e envie novamente |
| Resposta interrompida no meio da frase | Comprimento da resposta muito baixo no cliente | Aumentar o comprimento da resposta |
| Erro devido ao contexto muito longo | O 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