PT ▾
Obter chave de API

Open WebUI e n8n: conecte o chat a uma API sem censura

O Open WebUI oferece uma janela de chat, o n8n oferece automação e ambos podem usar o mesmo endpoint compatível com OpenAI. Veja como configurar cada um e como conversar a partir de um fluxo de trabalho no n8n.

Atualizado

Janela de chat e quadro de fluxo de trabalho conectados por um cabo a um servidor de API único, mostrando Open WebUI e n8n compartilhando um endpoint

Pontos principais

  1. No Open WebUI, adicione a URL base e a chave em Configurações do Admin, Conexões, ou defina duas variáveis de ambiente no Docker.
  2. No n8n, substitua a URL base nas credenciais do OpenAI ou use um nó HTTP Request.
  3. Use o ID do modelo uncensored em ambas as ferramentas.
  4. Mantenha os loops do n8n abaixo de 8 requisições simultâneas e ative a nova tentativa para respostas 429.

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: Bearer que 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:

  1. URL: https://api.nofilteraichat.com/v1
  2. Chave: sua chave de API
  3. 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:main

Abra 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:

  1. No n8n, crie uma nova credencial do tipo OpenAI.
  2. Cole sua chave de API.
  3. Defina a URL base como https://api.nofilteraichat.com/v1.
  4. 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 Authorization e valor Bearer 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

SintomaCausa provávelCorreção
Open WebUI não mostra modelosURL ou chave incorretosUse a URL base terminando em /v1; teste GET /v1/models com curl
Alterações de env do Docker ignoradasConfigurações já armazenadasEdite a conexão em Configurações do Admin
401 do n8nValor do cabeçalho faltando a palavra BearerO valor deve ler Bearer, um espaço e depois a chave
O Open WebUI no Docker não consegue alcançar um proxy localO localhost aponta para o containerUse o endereço do host, não localhost
429 no meio de um loopMuitos itens em paraleloAgrupe o nó HTTP e ative a nova tentativa
Modelo não encontradoNome digitado incorretamenteO ú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.

Perguntas e respostas

Como adiciono um endpoint OpenAI personalizado ao Open WebUI?

Vá para Configurações do Admin, Conexões, adicione uma conexão de API OpenAI com a URL base e sua chave. Ou defina OPENAI_API_BASE_URL e OPENAI_API_KEY ao iniciar o container Docker.

O n8n pode usar uma URL base diferente para nós OpenAI?

Sim. A credencial OpenAI tem um campo URL Base. Se o menu suspenso do modelo rejeitar uncensored, digite-o no modo de expressão ou use um nó de Requisição HTTP.

Por que meu loop no n8n retorna erros 429?

Você está enviando mais de 8 requisições paralelas ou mais de 300 por minuto em uma chave completa. Adicione lotes ao nó HTTP e ative a Tentativa em caso de Falha.

Posso usar a mesma chave no Open WebUI e no n8n ao mesmo tempo?

Sim, mas ambas as ferramentas compartilham um limite de 8 requisições concorrentes, então mantenha lotes de fluxo pequenos enquanto conversa.

Sua chave está a um clique de distância

Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.

Obter chave de API