O que você está configurando
Se você chegou aqui digitando openwebui como conversar n8n, provavelmente está tentando fazer duas coisas relacionadas: conversar com um modelo no Open WebUI e chamar o mesmo modelo a partir de fluxos de trabalho no n8n. Ambas as ferramentas podem apontar para qualquer servidor que siga o formato de conclusões de chat do OpenAI, então uma conta cobre ambos.
O Open WebUI é uma interface de chat auto-hospedada. O n8n é uma ferramenta de automação de fluxos de trabalho onde você conecta nós. A API por trás de ambos é a mesma em cada caso:
- URL base:
https://api.nofilteraichat.com/v1 - ID do modelo:
uncensored - Auth: um cabeçalho
Authorization: Bearerque carrega sua chave
Você precisa de uma chave primeiro. A página chave de API orienta sobre o cadastro e o crédito de teste de $0,50 com um clique, que é suficiente para testar tudo abaixo.
Parte um: Open WebUI
Opção A: o painel de administração
Se o Open WebUI já estiver em execução, entre como administrador e abra as Configurações do Admin, depois Conexões. Adicione uma nova conexão de API do OpenAI com estes valores:
- URL:
https://api.nofilteraichat.com/v1 - Chave: sua chave de API
- Salve e use o botão de verificação se sua versão tiver um.
Os nomes dos menus variam um pouco entre as versões, então procure a seção que lista conexões estilo OpenAI. Após salvar, inicie um novo chat e abra o seletor de modelos. O modelo uncensored deve aparecer, porque o Open WebUI carrega a lista a partir de GET /v1/models.
Opção B: variáveis de ambiente no Docker
Se estiver começando do zero, passe as configurações ao iniciar o container:
docker run -d --name open-webui -p 3000:8080 \
-e OPENAI_API_BASE_URL="https://api.nofilteraichat.com/v1" \
-e OPENAI_API_KEY="$NOFILTER_API_KEY" \
-v open-webui:/app/backend/data \
ghcr.io/open-webui/open-webui:mainAbra http://localhost:3000, crie a primeira conta local e o modelo estará disponível no seletor. Observe que o Open WebUI armazena as configurações de conexão em seu banco de dados após o primeiro lançamento. Se você alterar as variáveis mais tarde e nada acontecer, edite a conexão no painel de administração.
Ajustando um chat
Nos controles de chat, você pode definir temperatura, top_p, sequência de parada e prompt do sistema. Esses parâmetros passam para o modelo. Para ficção e roleplay, uma temperatura entre 0,7 e 1,0 gera prosa mais animada. Para perguntas factuais, vá para valores mais baixos. Se o modelo começar a repetir frases, aumente um pouco a penalidade de frequência.
Parte dois: n8n com o nó OpenAI
O n8n tem uma credencial nativa do OpenAI. Sua configuração inclui um campo URL base, que por padrão aponta para o servidor oficial. Altere-o e o nó falará com seu endpoint:
- No n8n, crie uma nova credencial do tipo OpenAI.
- Cole sua chave de API.
- Defina a URL base como
https://api.nofilteraichat.com/v1. - Salve e anexe a credencial a um nó Chat Model do OpenAI ou a um fluxo de trabalho de Agente de IA.
O problema é o campo do modelo. Alguns nós mostram um menu suspenso preenchido a partir da lista de modelos, e alguns limitam as escolhas a nomes conhecidos. Se você não puder selecionar uncensored, alterne o campo para o modo de expressão e digite o ID manualmente. Se sua versão do n8n ainda recusar, use a abordagem HTTP Request na próxima seção, que não tem essa restrição.
Com as credenciais funcionando, você pode conectar o modelo de chat a um nó de Agente de IA e fornecer ferramentas. A chamada de funções é suportada pela API (tools, tool_choice, e resultados como role: "tool"). Como em qualquer modelo de pesos abertos, teste o agente com entradas reais e mantenha as descrições das ferramentas curtas e literais.
Parte três: chat a partir de um nó HTTP Request
A opção mais previsível é um nó HTTP Request simples. Ele mostra exatamente o que é enviado e funciona em todas as versões do n8n. Configure o nó assim:
- Método: POST
- URL:
https://api.nofilteraichat.com/v1/chat/completions - Autenticação: Header Auth, com nome
Authorizatione valorBearer YOUR_KEY(armazene-o como credencial, não no nó) - Enviar Corpo: on, tipo de conteúdo JSON
Defina o corpo para o seguinte, usando uma expressão para o texto do usuário:
{
"model": "uncensored",
"messages": [
{ "role": "system", "content": "You are a concise story assistant for adult fiction writers." },
{ "role": "user", "content": "{{ $json.prompt }}" }
],
"temperature": 0.8,
"max_tokens": 600
}O texto da resposta está em choices[0].message.content. No próximo nó, leia-o com a expressão {{ $json.choices[0].message.content }}. A mesma resposta também contém um bloco usage, então você pode registrar contagens de tokens em uma planilha ou banco de dados.
Um fluxo de trabalho típico é um gatilho webhook, este nó HTTP e um nó de resposta que retorna o texto. Outro comum lê linhas de uma planilha, gera um rascunho para cada uma e grava os resultados de volta. Você também pode testar a solicitação fora do n8n primeiro com curl:
curl https://api.nofilteraichat.com/v1/chat/completions \
-H "Authorization: Bearer $NOFILTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'Limites, novas tentativas e lotes no n8n
Uma chave completa permite 8 requisições simultâneas e 300 requisições por minuto; uma chave de teste permite 2 e 60. O n8n pode facilmente exceder esses números, porque um nó processa cada item recebido e pode acioná-los rapidamente.
No nó Requisição HTTP, abra Opções e use Lote: defina um tamanho de lote de 4 ou 6 e um intervalo de um ou dois segundos. Nas Configurações do nó, ative a Tentativa em caso de Falha com 3 tentativas e uma espera de 5000 ms. Isso corresponde ao comportamento da API: quando ela está brevemente sobrecarregada, retorna HTTP 429 com um cabeçalho Retry-After: 5. Outros códigos 429 indicam qual limite você atingiu: rate_limited significa muitas requisições por minuto, concurrency significa muitas ao mesmo tempo.
O streaming merece uma observação. Uma requisição em streaming mantém seu slot de concorrência até o fim do streaming. No n8n, desative o streaming no nó HTTP, já que o fluxo de trabalho aguarda a resposta inteira. O Open WebUI faz streaming por padrão, o que é adequado para uma janela de chat.
Custo de um fluxo de trabalho
Suponha que um fluxo de trabalho processe 500 linhas, enviando 800 tokens de entrada e recebendo 250 tokens de saída para cada uma. Entrada: 500 × 800 = 400.000 tokens, que custam 400.000 × $0,15 / 1.000.000 = $0,06. Saída: 500 × 250 = 125.000 tokens, que custam 125.000 × $0,50 / 1.000.000 = $0,0625. A execução totaliza $0,1225, cerca de 12 centavos. Veja a página de preços para recargas.
Solução de Problemas
| Sintoma | Causa provável | Correção |
|---|---|---|
| Open WebUI não mostra modelos | URL ou chave incorretos | Use a URL base terminando em /v1; teste GET /v1/models com curl |
| Alterações de env do Docker ignoradas | Configurações já armazenadas | Edite a conexão em Configurações do Admin |
| 401 do n8n | Valor do cabeçalho faltando a palavra Bearer | O valor deve ler Bearer, um espaço e depois a chave |
| O Open WebUI no Docker não consegue alcançar um proxy local | O localhost aponta para o container | Use o endereço do host, não localhost |
| 429 no meio de um loop | Muitos itens em paralelo | Agrupe o nó HTTP e ative a nova tentativa |
| Modelo não encontrado | Nome digitado incorretamente | O único ID é uncensored |
Lembre-se dos limites do produto ao projetar um fluxo: apenas chat de texto, uma janela de contexto de 100.000 tokens compartilhada por prompt e resposta, e um corpo de requisição de 8 MB. Não há endpoint de embeddings, então mantenha qualquer busca vetorial em outro serviço. A iniciação rápida tem a referência completa da requisição, e o guia de integração cobre mais interfaces. Os prompts enviados pela API não são usados para treinamento.
A regra rígida se aplica em todas as ferramentas: sem conteúdo sexual envolvendo menores de idade. Dentro do uso adulto legal, o modelo é ajustado para responder sem recusas de conteúdo, o que é adequado para ficção, roleplay e aplicativos de companhia para adultos.
