n8n

O campo Base URL da credencial OpenAI — https://api.kunavo.com/v1, mantendo o /v1 — coloca todos os OpenAI Chat Models em um fluxo de trabalho do n8n na Kunavo; o próprio nó de modelo não tem campo de endpoint.

Credentials  →  Create credential  →  OpenAI
  API Key                      sk-kn-...
  Organization ID (optional)   leave empty
  Base URL                     https://api.kunavo.com/v1     <- keep the /v1

Workflow  →  AI Agent or Basic LLM Chain  →  Chat Model: OpenAI Chat Model
  Credential to connect with   the OpenAI credential above
  Model                        ID mode:  claude-sonnet-5
  Use Responses API            on   → POST /v1/responses
                               off  → POST /v1/chat/completions

Passo a passo

1. Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
2. No n8n, crie uma credencial do tipo OpenAI. Insira a chave em API Key, deixe Organization ID (optional) vazio e substitua o valor padrão https://api.openai.com/v1 de Base URL por https://api.kunavo.com/v1. Salve.
3. Adicione um nó AI Agent ou Basic LLM Chain e conecte um subnó OpenAI Chat Model usando essa credencial. Altere o campo Model de From List para ID e digite o ID conforme listado em GET /v1/models, por exemplo, claude-sonnet-5 — a lista também funciona, mas digitar o ID mantém o fluxo de trabalho legível.
4. Decida se deseja ativar Use Responses API: deixe ativado, a menos que uma ferramenta da sua cadeia espere Chat Completions ou que você queira que o registro de execução do n8n exiba uma solicitação de chat completions.
5. Execute o fluxo de trabalho uma vez com uma solicitação de uma linha antes de conectá-lo a um gatilho. Um 401 indica um problema com a chave; um 404 com o código missing_v1_prefix (ou, em execuções mais antigas, uma mensagem iniciada por <!DOCTYPE html>) indica que /v1 foi removido da Base URL.

Verificado em Código-fonte da credencial OpenAI do n8n na tag n8n@2.41.4 em 1 de outubro de 2026. As configurações de terceiros podem mudar; se o nome de um campo aqui já não corresponder ao que você vê, aquela página é a autoridade, não esta.

Verifique antes de depurar o cliente

Uma solicitação determina se a falha está no endpoint, na chave ou no arquivo de configuração. Se isto retornar JSON, a mesma URL base e a mesma chave funcionarão em n8n.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qual ID de modelo inserir no campo

Todo modelo de texto pode ser acessado como um ID de modelo — a lista atual está em GET /v1/models, e o catálogo com preços está na página de modelos. As tarifas são em USD por 1 milhão de tokens, entrada / saída.

Por que a Base URL fica na credencial

Tutoriais mais antigos configuram o endpoint dentro do nó do modelo. No código-fonte da versão lançada, essa opção Base URL dentro do nó fica oculta a partir da versão 1.1; portanto, um nó adicionado hoje não tem esse campo, e vale a Base URL da credencial. A documentação do OpenAI Chat Model e a página de credenciais do próprio n8n não descrevem esse campo; o código-fonte, sim, com a descrição “Override the default base URL for the API”. O nó HTTP Request é uma rota completamente diferente — funciona, mas você teria de montar manualmente a solicitação que um nó AI Agent monta para você.

Responses API ativada ou desativada

• Ativada (o padrão no nó 1.3) — as solicitações vão para /v1/responses. Este é o único modo que exibe as Built-in Tools do nó: Web Search, File Search e Code Interpreter. Essas ferramentas são hospedadas pela OpenAI; ninguém as testou por meio da Kunavo, então não crie um fluxo de trabalho que dependa delas sem testá-las antes.
• Desativada — as solicitações vão para /v1/chat/completions, o formato mais amplamente compatível e a opção para usar caso uma chamada de ferramenta se comporte de maneira inesperada na outra configuração.
• As ferramentas que você conecta a um AI Agent são enviadas ao modelo como definições de funções. Essa ida e volta não fez parte desta verificação, então execute uma chamada de ferramenta em um fluxo de trabalho de teste antes de depender dela.

n8n e OpenRouter

O n8n inclui um nó OpenRouter Chat Model separado, com sua própria credencial OpenRouter. Essa credencial tem um campo API Key e uma Base URL oculta, definida como https://openrouter.ai/api/v1; o teste chama a rota /key da própria OpenRouter — portanto, o nó OpenRouter só pode se comunicar com a OpenRouter. Se é isso que você quer, use esse nó com uma chave OpenRouter; nada nesta página será necessário.

Qualquer outro endpoint compatível com OpenAI, incluindo a Kunavo, passa pelo OpenAI Chat Model e pela Base URL da credencial OpenAI, como descrito acima. Escolha entre eles com base no que realmente difere — quais modelos você precisa, como quer pagar e se quer um único saldo para o n8n e as outras ferramentas —, não com base no nó. A comparação do lado da Kunavo está em Kunavo vs OpenRouter.

Como manter sob controle o custo de um fluxo de trabalho autônomo

• O padrão de Max Retries do nó é 2, e o de Timeout é 60000 ms. Uma solicitação que atinge o tempo limite é repetida, e cada repetição é uma nova solicitação cobrada.
• Defina Maximum Number of Tokens nos nós executados por item — um loop com 1,000 linhas multiplica o custo de cada chamada.
• Use uma chave Kunavo separada para cada fluxo de trabalho de produção, para que a página de uso mostre quanto cada um gastou e você possa revogar uma sem afetar as outras.

Como são os erros

• “401 Missing or invalid API key” — a Base URL está correta, mas a chave não. Reproduzido na versão 2.41.4.
• “404 <!DOCTYPE html>…”, classificado pela LangChain como MODEL_NOT_FOUND — é enganoso: o modelo está correto, mas falta /v1 na Base URL e a solicitação chegou ao site. Reproduzido na versão 2.41.4.
• Uma mensagem JSON informando que o modelo não está disponível — o ID do modelo não corresponde exatamente a GET /v1/models.