n8n

Wywołuj OneProvider z n8n za pomocą zwykłego węzła HTTP Request. Niestandardowy węzeł społeczności nie jest potrzebny — surowe Anthropic Messages API działa bez zmian.

1. Utwórz poświadczenie

W n8n wybierz Credentials → New → Header Auth i ustaw:

• Name: x-api-key
• Value: twój klucz OneProvider (sk-...)

2. HTTP Request node

Dodaj do workflow węzeł HTTP Request i skonfiguruj go:

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

Wyrażenie {{$json.prompt}} pobiera tekst z poprzedniego węzła; zastąp je dowolnym wyrażeniem n8n, które zwraca ciąg znaków.

Strumieniowanie

Dodaj "stream": true do treści żądania i przełącz w węźle Response → Response Format na String. n8n odbierze strumień bajtów SSE; linie data: przetwórz w węźle Function dalej w przepływie.

Jaki model wybrać

ID modelu wpisz w treści JSON. claude-sonnet-5-5 to domyślny wybór dla większości workflow: zrównoważona cena i jakość przy streszczeniach, klasyfikacji i szkicach. claude-haiku-5-5 użyj do prostych kroków o dużym wolumenie, takich jak tagowanie czy routing, a claude-opus-5-5 do kroków wymagających głębokiego rozumowania. Zawsze ustawiaj max_tokens: Messages API tego wymaga. ID są na stronie modeli , stawki na stronie cennika ; limit wydatków na kluczu chroni przed workflow wpadającym w pętlę.

Częste błędy i rozwiązania

401 authentication_error

Poświadczenie Header Auth musi mieć dokładnie nazwę x-api-key, a jako wartość cały klucz. Sprawdź, czy węzeł faktycznie używa tego poświadczenia.

404 w węźle HTTP Request

URL musi mieć postać https://api.oneprovider.dev/v1/messages. Brak /v1 i podwojone /v1 dają 404.

400 invalid_request_error

Sprawdź treść JSON: wymagane są model, max_tokens i niepusta tablica messages, a wyrażenie {{$json.prompt}} musi zwracać ciąg znaków, nie obiekt.

429 „Insufficient balance”, a węzeł wciąż ponawia

Wyłącz Settings → Retry On Fail dla tego węzła albo ogranicz liczbę prób: odpowiedź zawiera x-should-retry: false, a ponowienia tylko tracą czas. Zamiast tego doładuj saldo.

Węzeł przekracza limit czasu przy długiej odpowiedzi

Zwiększ Options → Timeout w węźle albo użyj "stream": true. Żądanie bez strumieniowania musi zacząć odpowiadać w ciągu 6 minut.

Nie mogę znaleźć tekstu odpowiedzi

W Messages API tekst jest w {{$json.content[0].text}}. W /v1/chat/completions jest w {{$json.choices[0].message.content}}.

FAQ

Czy potrzebuję węzła społeczności?

Nie. Wystarczy standardowy węzeł HTTP Request.

Czy mogę użyć wbudowanych węzłów OpenAI w n8n?

Zwykle tak: utwórz poświadczenie OpenAI, ustaw jego Base URL na https://api.oneprovider.dev/v1, a potem wpisz ręcznie ID modelu z katalogu.

Jak sprawić, żeby jeden workflow nie wydał za dużo?

Utwórz osobny klucz dla n8n z limitem wydatków i używaj go tylko tam.

Czy mogę wywoływać też modele GPT?

Tak, przez https://api.oneprovider.dev/v1/chat/completions z tym samym kluczem i treścią w stylu OpenAI, zobacz Chat Completions .

Szybkie odpowiedzi

Jakiego base URL użyć?

Claude Code i SDK Anthropic używają https://api.oneprovider.dev. SDK OpenAI i klienty zgodne z OpenAI używają https://api.oneprovider.dev/v1. Jeden klucz działa przy obu; lista modeli jest na stronie modeli , a stawki na stronie cennika .

Jak się uwierzytelnić?

Wyślij surowy klucz sk-… w x-api-key albo Authorization: Bearer: w jednym z nich, nigdy w obu. Trzymaj klucz w zmiennej środowiskowej, a nie w pliku, który trafia do repozytorium. Więcej o uwierzytelnianiu .

Skąd wziąć klucz?

Otwórz swój Panel w bocie Telegram @oneprovider_robot lub na app.oneprovider.dev, doładuj saldo i naciśnij „Utwórz klucz”. Każdy klucz może mieć własny limit wydatków. Panel i klucze API .

Co oznaczają 401, 404 i 429?

401: klucza brakuje, jest błędnie wpisany albo wysłany w złym nagłówku; wklej cały klucz bez cudzysłowów i spacji. 404: zwykle zły base URL, na przykład brakujące lub podwojone /v1. 429 z komunikatem „Insufficient balance”: saldo Panelu lub limit wydatków klucza się wyczerpał, więc doładuj zamiast ponawiać; każde inne 429 to limit zapytań, więc poczekaj zgodnie z Retry-After. Szczegóły: kody błędów i rozwiązywanie problemów .

Dlaczego strumienie się urywają lub resetują?

VPN i proxy VLESS często buforują SSE albo zrywają negocjację HTTP/2. OneProvider nie ma ograniczeń regionalnych i nie buforuje strumieni, więc wyłącz proxy i spróbuj ponownie.

Gdzie pytać, jeśli to nie wystarcza?

Napisz do @Oneproviderhelpbot w Telegramie albo otwórz „Wsparcie” w Panelu w przeglądarce, podając kod statusu HTTP i dokładny komunikat błędu. Jak działa wsparcie .