n8n

OneProvider aus n8n mit einem gewöhnlichen HTTP-Request-Node aufrufen. Ein eigener Community-Node ist nicht nötig – die rohe Anthropic Messages API funktioniert unverändert.

1. Credential anlegen

Wählen Sie in n8n Credentials → New → Header Auth und tragen Sie ein:

• Name: x-api-key
• Value: Ihr OneProvider-Schlüssel (sk-...)

2. HTTP Request node

Ziehen Sie einen HTTP Request-Node in Ihren Workflow und konfigurieren Sie ihn:

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

Der Ausdruck {{$json.prompt}} holt Text aus dem vorherigen Node; ersetzen Sie ihn durch einen beliebigen n8n-Ausdruck, der einen String liefert.

Streaming

Ergänzen Sie "stream": true im Body und stellen Sie im Node Response → Response Format auf String. n8n erhält dann den SSE-Bytestrom; werten Sie die data:-Zeilen in einem nachgelagerten Function-Node aus.

Welches Modell wählen

Tragen Sie die Modell-ID im JSON-Body ein. claude-sonnet-5-5 ist der Standard für die meisten Workflows: ausgewogenes Verhältnis von Preis und Qualität für Zusammenfassungen, Klassifizierung und Entwürfe. Nutzen Sie claude-haiku-5-5 für einfache Schritte mit hohem Volumen wie Tagging oder Routing und claude-opus-5-5 für Schritte, die tiefes Schlussfolgern brauchen. Setzen Sie immer max_tokens: Die Messages API verlangt es. IDs stehen auf der Modellseite , die Preise auf der Preisseite ; ein Ausgabenlimit für den Schlüssel schützt einen Workflow, der in einer Schleife läuft.

Häufige Fehler und Lösungen

401 authentication_error

Das Header-Auth-Credential muss exakt den Namen x-api-key und den ganzen Schlüssel als Wert haben. Prüfen Sie, ob der Node dieses Credential tatsächlich verwendet.

404 am HTTP-Request-Node

Die URL muss https://api.oneprovider.dev/v1/messages lauten. Sowohl ein fehlendes als auch ein doppeltes /v1 liefert 404.

400 invalid_request_error

Prüfen Sie den JSON-Body: model, max_tokens und ein nicht leeres Array messages sind Pflicht, und der Ausdruck {{$json.prompt}} muss einen String liefern, kein Objekt.

429 „Insufficient balance“ und der Node wiederholt den Aufruf ständig

Schalten Sie Settings → Retry On Fail für diesen Node aus oder begrenzen Sie die Versuche: Die Antwort enthält x-should-retry: false, Wiederholungen kosten nur Zeit. Laden Sie stattdessen das Konto auf.

Der Node läuft bei einer langen Antwort in den Timeout

Erhöhen Sie Options → Timeout am Node oder nutzen Sie "stream": true. Eine Anfrage ohne Streaming muss innerhalb von 6 Minuten mit der Antwort beginnen.

Ich finde den Antworttext nicht

Bei der Messages API steht der Text in {{$json.content[0].text}}. Bei /v1/chat/completions steht er in {{$json.choices[0].message.content}}.

FAQ

Brauche ich einen Community-Node?

Nein. Der Standard-HTTP-Request-Node genügt.

Kann ich die eingebauten OpenAI-Nodes von n8n nutzen?

In der Regel ja: Legen Sie ein OpenAI-Credential an und setzen Sie dessen Base URL auf https://api.oneprovider.dev/v1, wählen Sie dann eine Modell-ID aus dem Katalog von Hand.

Wie verhindere ich, dass ein Workflow zu viel ausgibt?

Stellen Sie einen eigenen Schlüssel für n8n mit Ausgabenlimit aus und nutzen Sie ihn nur dort.

Kann ich auch GPT-Modelle aufrufen?

Ja, über https://api.oneprovider.dev/v1/chat/completions mit demselben Schlüssel und einem Body im OpenAI-Stil, siehe Chat Completions .

Kurze Antworten

Welche base URL verwende ich?

Claude Code und die Anthropic-SDKs verwenden https://api.oneprovider.dev. OpenAI-SDKs und OpenAI-kompatible Clients verwenden https://api.oneprovider.dev/v1. Ein Schlüssel funktioniert an beiden Adressen; die Modellliste finden Sie auf der Modellseite , die Preise auf der Preisseite .

Wie authentifiziere ich mich?

Senden Sie den unveränderten sk-…-Schlüssel in x-api-key oder Authorization: Bearer: nur eines von beiden, nie beide. Bewahren Sie den Schlüssel in einer Umgebungsvariable auf, nicht in einer Datei, die ins Repository committet wird. Mehr zur Authentifizierung .

Wo bekomme ich einen Schlüssel?

Öffnen Sie Ihr Konto im Telegram-Bot @oneprovider_robot oder auf app.oneprovider.dev, laden Sie das Guthaben auf und tippen Sie auf „Schlüssel ausstellen“. Jeder Schlüssel kann ein eigenes Ausgabenlimit haben. Konto & API-Schlüssel .

Was bedeuten 401, 404 und 429?

401: Der Schlüssel fehlt, ist falsch geschrieben oder steht im falschen Header; fügen Sie den ganzen Schlüssel ohne Anführungszeichen und Leerzeichen ein. 404: meist eine falsche base URL, zum Beispiel ein fehlendes oder doppeltes /v1. 429 mit „Insufficient balance“: Das Guthaben des Kontos oder das Ausgabenlimit des Schlüssels ist aufgebraucht – laden Sie auf, statt es erneut zu versuchen; jedes andere 429 ist ein Rate-Limit, warten Sie dann die Zeit aus Retry-After ab. Details: Fehlercodes und Fehlerbehebung .

Warum brechen Streams ab oder werden zurückgesetzt?

VPN- und VLESS-Proxys puffern SSE oft oder stören die HTTP/2-Aushandlung. OneProvider hat keine regionalen Beschränkungen und puffert keine Streams – schalten Sie den Proxy aus und versuchen Sie es erneut.

Wohin wende ich mich, wenn das nicht reicht?

Schreiben Sie @Oneproviderhelpbot auf Telegram oder öffnen Sie „Support“ im Web-Konto – mit HTTP-Statuscode und genauer Fehlermeldung. So arbeitet der Support .