n8n

Appelez OneProvider depuis n8n avec un simple nœud HTTP Request. Aucun nœud communautaire personnalisé n’est nécessaire — l’API Anthropic Messages brute fonctionne telle quelle.

1. Créer un identifiant

Dans n8n, Credentials (identifiants) → New → Header Auth. Renseignez :

• Name: x-api-key
• Value : votre clé OneProvider (sk-...)

2. HTTP Request node

Déposez un nœud HTTP Request dans votre workflow et configurez-le :

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’expression {{$json.prompt}} récupère le texte du nœud précédent ; remplacez-la par n’importe quelle expression n8n qui produit une chaîne.

Streaming

Ajoutez "stream": true au corps de la requête et réglez Response → Response Format du nœud sur String. n8n recevra le flux d’octets SSE ; analysez les lignes data: dans un nœud Function en aval.

Quel modèle choisir

Mettez l’ID du modèle dans le corps JSON. claude-sonnet-5-5 est le choix par défaut pour la plupart des workflows : prix et qualité équilibrés pour les résumés, la classification et les brouillons. Utilisez claude-haiku-5-5 pour les étapes simples à gros volume comme l’étiquetage ou le routage, et claude-opus-5-5 pour les étapes qui demandent un raisonnement approfondi. Définissez toujours max_tokens : l’API Messages l’exige. Les ID sont sur la page des modèles , les tarifs sur la page des tarifs  ; une limite de dépense sur la clé protège un workflow qui boucle.

Erreurs courantes et solutions

401 authentication_error

L’identifiant Header Auth doit avoir exactement le nom x-api-key et la clé entière comme valeur. Vérifiez que le nœud utilise bien cet identifiant.

404 sur le nœud HTTP Request

L’URL doit être https://api.oneprovider.dev/v1/messages. Un /v1 manquant ou doublé renvoie un 404 dans les deux cas.

400 invalid_request_error

Vérifiez le corps JSON : model, max_tokens et un tableau messages non vide sont obligatoires, et l’expression {{$json.prompt}} doit produire une chaîne, pas un objet.

429 « Insufficient balance » et le nœud réessaie sans cesse

Désactivez Settings → Retry On Fail pour ce nœud, ou limitez le nombre d’essais : la réponse contient x-should-retry: false et les nouvelles tentatives ne font que perdre du temps. Rechargez plutôt le solde de l’espace client.

Le nœud expire sur une longue réponse

Augmentez Options → Timeout sur le nœud, ou utilisez "stream": true. Une requête sans streaming doit commencer à répondre en moins de 6 minutes.

Je ne trouve pas le texte de la réponse

Avec l’API Messages, le texte se trouve dans {{$json.content[0].text}}. Avec /v1/chat/completions, il est dans {{$json.choices[0].message.content}}.

FAQ

Ai-je besoin d’un nœud communautaire ?

Non. Le nœud HTTP Request standard suffit.

Puis-je utiliser les nœuds OpenAI intégrés de n8n ?

En général oui : créez un identifiant OpenAI et réglez sa Base URL sur https://api.oneprovider.dev/v1, puis choisissez à la main un ID de modèle du catalogue.

Comment empêcher un workflow de trop dépenser ?

Créez une clé distincte pour n8n avec une limite de dépense et n’utilisez-la que là.

Puis-je aussi appeler des modèles GPT ?

Oui, via https://api.oneprovider.dev/v1/chat/completions avec la même clé et un corps au style OpenAI, voir Chat Completions .

Réponses rapides

Quelle base URL utiliser ?

Claude Code et les SDK Anthropic utilisent https://api.oneprovider.dev. Les SDK OpenAI et les clients compatibles OpenAI utilisent https://api.oneprovider.dev/v1. Une seule clé fonctionne avec les deux ; la liste des modèles est sur la page des modèles , les tarifs sur la page des tarifs .

Comment s’authentifier ?

Envoyez la clé sk-… telle quelle dans x-api-key ou Authorization: Bearer : l’un des deux, jamais les deux. Conservez la clé dans une variable d’environnement, pas dans un fichier qui sera commité. En savoir plus sur l’authentification .

Où obtenir une clé ?

Ouvrez votre espace client dans le bot Telegram @oneprovider_robot ou sur app.oneprovider.dev, rechargez le solde et appuyez sur « Créer une clé ». Chaque clé peut avoir sa propre limite de dépense. Espace client et clés API .

Que signifient 401, 404 et 429 ?

401 : la clé est absente, mal saisie ou envoyée dans le mauvais en-tête ; collez la clé entière, sans guillemets ni espaces. 404 : le plus souvent une base URL incorrecte, par exemple un /v1 manquant ou en double. 429 avec « Insufficient balance » : le solde de l’espace client est à zéro ou la clé a atteint sa limite de dépense, donc rechargez au lieu de réessayer ; tout autre 429 est une limite de débit, donc attendez le délai indiqué par Retry-After. Détails : codes d’erreur et dépannage .

Pourquoi les flux se coupent-ils ou se réinitialisent-ils ?

Les VPN et les proxys VLESS mettent souvent le SSE en mémoire tampon ou perturbent la négociation HTTP/2. OneProvider n’a aucune restriction régionale et ne met pas les flux en mémoire tampon : désactivez le proxy et réessayez.

Où demander de l’aide si cela ne suffit pas ?

Écrivez à @Oneproviderhelpbot sur Telegram ou ouvrez « Support » dans l’espace client web, en indiquant le code de statut HTTP et le message d’erreur exact. Comment fonctionne le support .