n8n

Chiama OneProvider da n8n con un normale nodo HTTP Request. Non serve alcun nodo community personalizzato: l'API Anthropic Messages grezza funziona così com'è.

1. Crea una credenziale

In n8n vai su Credentials → New → Header Auth. Imposta:

• Name: x-api-key
• Value: la tua chiave OneProvider (sk-...)

2. HTTP Request node

Trascina un nodo HTTP Request nel tuo workflow e configuralo:

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}}" }
]
}

L'espressione {{$json.prompt}} prende il testo dal nodo precedente; sostituiscila con qualsiasi espressione n8n che restituisca una stringa.

Streaming

Aggiungi "stream": true al corpo e imposta Response → Response Format del nodo su String. n8n riceverà il flusso di byte SSE; analizza le righe data: in un nodo Function a valle.

Quale modello scegliere

Metti l'ID del modello nel corpo JSON. claude-sonnet-5-5 è la scelta predefinita per la maggior parte dei workflow: prezzo e qualità bilanciati per riassunti, classificazione e bozze. Usa claude-haiku-5-5 per passaggi semplici ad alto volume, come etichettatura o instradamento, e claude-opus-5-5 per i passaggi che richiedono un ragionamento profondo. Imposta sempre max_tokens: la Messages API lo richiede. Gli ID sono nella pagina dei modelli , le tariffe nella pagina dei prezzi ; un limite di spesa sulla chiave protegge un workflow che va in loop.

Errori comuni e soluzioni

401 authentication_error

La credenziale Header Auth deve avere esattamente il nome x-api-key e la chiave intera come valore. Verifica che il nodo usi davvero questa credenziale.

404 sul nodo HTTP Request

L'URL deve essere https://api.oneprovider.dev/v1/messages. Sia un /v1 mancante sia uno doppio restituiscono 404.

400 invalid_request_error

Controlla il corpo JSON: model, max_tokens e un array messages non vuoto sono obbligatori, e l'espressione {{$json.prompt}} deve produrre una stringa, non un oggetto.

429 «Insufficient balance» e il nodo continua a riprovare

Disattiva Settings → Retry On Fail per questo nodo, o limita i tentativi: la risposta contiene x-should-retry: false e i tentativi fanno solo perdere tempo. Ricarica invece l'area personale.

Il nodo va in timeout con una risposta lunga

Alza Options → Timeout sul nodo, oppure usa "stream": true. Una richiesta senza streaming deve iniziare a rispondere entro 6 minuti.

Non trovo il testo della risposta

Con la Messages API il testo è in {{$json.content[0].text}}. Con /v1/chat/completions è in {{$json.choices[0].message.content}}.

FAQ

Mi serve un nodo community?

No. Basta il nodo HTTP Request standard.

Posso usare i nodi OpenAI integrati di n8n?

Di solito sì: crea una credenziale OpenAI e imposta la sua Base URL su https://api.oneprovider.dev/v1, poi scegli a mano un ID di modello dal catalogo.

Come evito che un workflow spenda troppo?

Emetti per n8n una chiave separata con un limite di spesa e usala solo lì.

Posso chiamare anche i modelli GPT?

Sì, tramite https://api.oneprovider.dev/v1/chat/completions con la stessa chiave e un corpo in stile OpenAI, vedi Chat Completions .

Risposte rapide

Quale base URL devo usare?

Claude Code e gli SDK Anthropic usano https://api.oneprovider.dev. Gli SDK OpenAI e i client compatibili con OpenAI usano https://api.oneprovider.dev/v1. Con una sola chiave funzionano entrambi; l'elenco dei modelli è nella pagina dei modelli , le tariffe nella pagina dei prezzi .

Come mi autentico?

Invia la chiave sk-… così com'è in x-api-key oppure in Authorization: Bearer: uno dei due, mai entrambi. Tieni la chiave in una variabile d'ambiente, non in un file che finisce nel commit. Altro sull'autenticazione .

Dove ottengo una chiave?

Apri la tua area personale nel bot Telegram @oneprovider_robot oppure su app.oneprovider.dev, ricarica il saldo e premi «Emetti una chiave». Ogni chiave può avere un proprio limite di spesa. Area personale e chiavi API .

Cosa significano 401, 404 e 429?

401: la chiave manca, è scritta male o è inviata nell'header sbagliato; incolla la chiave intera, senza virgolette né spazi. 404: di solito la base URL è sbagliata, per esempio manca /v1 o è doppio. 429 con “Insufficient balance”: il saldo dell'area personale o il limite di spesa della chiave è esaurito, quindi ricarica invece di riprovare; qualsiasi altro 429 è un limite di frequenza, quindi attendi il tempo indicato in Retry-After. Dettagli: codici di errore e risoluzione dei problemi .

Perché gli stream si interrompono o si resettano?

VPN e proxy VLESS spesso mettono in buffer gli SSE o rompono la negoziazione HTTP/2. OneProvider non ha restrizioni regionali e non mette in buffer gli stream: disattiva il proxy e riprova.

Dove chiedo se non basta?

Scrivi a @Oneproviderhelpbot su Telegram oppure apri «Assistenza» nell'area personale sul sito, indicando il codice di stato HTTP e il testo esatto dell'errore. Come funziona l'assistenza .