n8n

Chame a OneProvider no n8n com um nó HTTP Request comum. Não precisa de nenhum nó personalizado da comunidade — a API Messages da Anthropic funciona como está.

1. Crie uma credencial

No n8n, vá em Credentials → New → Header Auth. Defina:

• Name: x-api-key
• Value: a sua chave da OneProvider (sk-...)

2. HTTP Request node

Arraste um nó HTTP Request para o seu workflow e configure:

Method: POST
URL: https://api.oneprovider.dev/v1/messages
Authentication: Header Auth → (the credential above)
Headers:
anthropic-version: 2023-06-01
content-type: application/json
Body (JSON):
{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [
{ "role": "user", "content": "{{$json.prompt}}" }
]
}

A expressão {{$json.prompt}} pega o texto do nó anterior; troque-a por qualquer expressão do n8n que produza uma string.

Streaming

Adicione "stream": true ao corpo e mude Response → Response Format do nó para String. O n8n vai receber o fluxo de bytes SSE; processe as linhas data: em um nó Function mais adiante.

Qual modelo escolher

Coloque o ID do modelo no corpo JSON. claude-sonnet-5-5 é o padrão para a maioria dos workflows: preço e qualidade equilibrados para resumos, classificação e rascunhos. Use claude-haiku-5-5 em etapas simples e de alto volume, como etiquetar ou rotear, e claude-opus-5-5 nas etapas que exigem raciocínio profundo. Sempre defina max_tokens: a API Messages exige. Os IDs estão na página de modelos e os valores na página de preços ; um limite de gastos na chave protege um workflow que entra em loop.

Erros comuns e soluções

401 authentication_error

A credencial Header Auth deve ter exatamente o nome x-api-key e a chave inteira como valor. Confira se o nó realmente usa essa credencial.

404 no nó HTTP Request

A URL deve ser https://api.oneprovider.dev/v1/messages. Faltar o /v1 ou repeti-lo retorna 404 nos dois casos.

400 invalid_request_error

Confira o corpo JSON: model, max_tokens e um array messages não vazio são obrigatórios, e a expressão {{$json.prompt}} deve produzir uma string, não um objeto.

429 “Insufficient balance” e o nó fica tentando de novo

Desligue Settings → Retry On Fail neste nó ou limite as tentativas: a resposta traz x-should-retry: false e repetir só perde tempo. Recarregue o saldo do painel.

O nó expira (timeout) numa resposta longa

Aumente Options → Timeout no nó ou use "stream": true. Uma requisição sem streaming precisa começar a responder em até 6 minutos.

Não encontro o texto da resposta

Com a API Messages, o texto está em {{$json.content[0].text}}. Com /v1/chat/completions, está em {{$json.choices[0].message.content}}.

Perguntas frequentes

Preciso de um nó da comunidade?

Não. O nó HTTP Request padrão basta.

Posso usar os nós OpenAI integrados do n8n?

Em geral, sim: crie uma credencial OpenAI, defina a Base URL como https://api.oneprovider.dev/v1 e escolha à mão um ID de modelo do catálogo.

Como impeço que um workflow gaste demais?

Emita uma chave separada para o n8n, com limite de gastos, e use-a só lá.

Posso chamar modelos GPT também?

Pode, por https://api.oneprovider.dev/v1/chat/completions, com a mesma chave e um corpo no estilo OpenAI, veja Chat Completions .

Respostas rápidas

Qual base URL devo usar?

O Claude Code e os SDKs da Anthropic usam https://api.oneprovider.dev. Os SDKs da OpenAI e os clientes compatíveis com a OpenAI usam https://api.oneprovider.dev/v1. Uma única chave funciona nos dois; a lista de modelos está na página de modelos e os preços, na página de preços .

Como me autentico?

Envie a chave sk-… pura em x-api-key ou em Authorization: Bearer: um dos dois, nunca ambos. Guarde a chave em uma variável de ambiente, não em um arquivo que vai para o commit. Mais sobre autenticação .

Onde consigo uma chave?

Abra o seu painel no bot do Telegram @oneprovider_robot ou em app.oneprovider.dev, recarregue o saldo e toque em “Emitir chave”. Cada chave pode ter o seu próprio limite de gastos. Painel e chaves de API .

O que significam 401, 404 e 429?

401: a chave está ausente, foi digitada errado ou enviada no cabeçalho errado; cole a chave inteira, sem aspas nem espaços. 404: em geral, uma base URL errada, por exemplo um /v1 ausente ou duplicado. 429 com “Insufficient balance”: o saldo do painel ou o limite de gastos da chave acabou, então recarregue em vez de tentar de novo; qualquer outro 429 é um limite de requisições, então aguarde o tempo de Retry-After. Detalhes: códigos de erro e solução de problemas .

Por que os streams são cortados ou reiniciados?

VPNs e proxies VLESS costumam armazenar SSE em buffer ou quebrar a negociação do HTTP/2. A OneProvider não tem restrições regionais e não armazena streams em buffer; desative o proxy e tente de novo.

Onde pergunto se isso não bastar?

Escreva para @Oneproviderhelpbot no Telegram ou abra “Suporte” no painel web, informando o código de status HTTP e a mensagem de erro exata. Como funciona o suporte .