PL ▾
Pobierz klucz API

Kompatybilne z API OpenAI w n8n: Przewodnik konfiguracji

Jeśli szukałeś frazy „openai compatible api n8n”, krótka odpowiedź brzmi: zmieniasz tylko dwie wartości w poświadczeniach OpenAI, adres URL podstawowy i klucz API. Reszta potoku pozostaje taka sama jak dla każdego węzła OpenAI.

Zaktualizowano

Izometryczny potok automatyzacji z połączonymi blokami wysyłającymi dane do terminalu API

Kluczowe punkty

Czego potrzebujesz przed rozpoczęciem

Instancja n8n (chmurowa lub self-hosted) oraz klucz API z tego serwisu. Jeśli nie masz jeszcze klucza, strona klucz API przeprowadzi Cię przez rejestrację za pomocą Google lub e-maila i hasła. Nowi użytkownicy mogą jednym kliknięciem uzyskać $0,50 kredytu próbnego na stronie, ważnego przez 7 dni bez podawania karty.

Do n8n wprowadza się trzy wartości:

  • Adres URL podstawowy: https://api.onekeyllmapi.com/v1
  • Klucz API: wysyłany jako Authorization: Bearer <key>, co n8n robi za Ciebie
  • Identyfikator modelu: uncensored

Usługa to hostowane, tekstowe API LLM, które stosuje format żądań OpenAI dla /v1/chat/completions, /v1/responses i /v1/models. Nie jest to oficjalne API żadnego dostawcy modeli, więc wszystko, co n8n wyśle do endpointu czatu OpenAI, zadziała tutaj, o ile jest to żądanie tekstowe.

Krok 1: Utwórz poświadczenie

W n8n otwórz Credentials, wybierz Create credential i wyszukaj OpenAI API. Wypełnij go w ten sposób:

  1. Wklej swój klucz w pole API Key.
  2. Pozostaw pole Organization ID puste.
  3. Zamień domyślne Base URL na https://api.onekeyllmapi.com/v1. Zachowaj /v1 na końcu i nie dodawaj /chat/completions.
  4. Zapisz. n8n wykonuje małe testowe wywołanie przy zapisie; jeśli się nie powiedzie, przejdź do sekcji rozwiązywania problemów poniżej.

Przechowuj jeden zestaw poświadczeń na środowisko. Jeśli uruchamiasz środowisko testowe i produkcyjne w n8n, przypisz do każdego osobny klucz, abyś mógł śledzić wydatki oddzielnie i unieważnić jeden bez wpływu na drugi.

Krok 2: Zbuduj prosty workflow czatu

Zacznij od najmniejszej rzeczy, która potwierdzi połączenie: manualny trigger i jedno wywołanie modelu.

  1. Dodaj węzeł Manual Trigger.
  2. Dodaj węzeł OpenAI (lub podwęzeł OpenAI Chat Model wewnątrz Basic LLM Chain, w zależności od wersji n8n) i wybierz dane logowania z kroku 1.
  3. W przypadku modelu poszukaj sposobu na ręczne wpisanie ID. Nowe wersje n8n oferują tryb By ID obok listy. Wpisz tam uncensored. Lista może być pusta lub wyświetlać tylko nazwy OpenAI, ponieważ n8n filtruje ją po swojej stronie.
  4. Dodaj prompt, np. Podsumuj to zgłoszenie do pomocy technicznej w dwóch zdaniach i uruchom węzeł.

Jeśli Twoja wersja n8n wymusza wybór z listy, użyj podejścia HTTP Request w następnej sekcji. Zawsze działa, ponieważ kontrolujesz całe żądanie.

Wywoływanie API węzłem HTTP Request

Węzeł HTTP Request to najprzewidywalniejszy sposób wywołania tego API z n8n i udostępnia każdy parametr, który API akceptuje, w tym seed, stop, top_p i tools. Skonfiguruj go w ten sposób:

  • Metoda: POST
  • Adres URL: https://api.onekeyllmapi.com/v1/chat/completions
  • Uwierzytelnianie: Generic Credential Type z Header Auth, nazwa Authorization, wartość Bearer YOUR_KEY
  • Wyślij ciało: włącz, typ zawartości JSON

Treść (przełącz pole na Expression, jeśli chcesz wstawić dane z wcześniejszych węzłów):

{
  "model": "uncensored",
  "messages": [
    {"role": "system", "content": "You are a concise assistant."},
    {"role": "user", "content": "Summarize this support ticket in two sentences."}
  ],
  "temperature": 0.4
}

Tekst odpowiedzi znajduje się pod choices[0].message.content. W kolejnym węźle możesz odwołać się do niego za pomocą {{ $json.choices[0].message.content }}.

Aby przetestować to samo żądanie poza n8n najpierw, uruchom to w terminalu:

curl https://api.onekeyllmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'

Jeśli curl działa, a n8n nie, problem jest w ustawieniach węzła, a nie w Twoim kluczu lub saldzie.

Tryb JSON dla workflow przetwarzających dane wyjściowe

Workflow'y łamią się, gdy model opakowuje dane w przyjazny tekst. Tryb JSON prosi API o zwrócenie poprawnego obiektu JSON, który możesz przekazać bezpośrednio do węzła Set lub IF. Dodaj response_format do ciała żądania:

{
  "model": "uncensored",
  "response_format": {"type": "json_object"},
  "messages": [
    {"role": "system", "content": "Reply only with a JSON object with keys sentiment and summary."},
    {"role": "user", "content": "The delivery was late but support fixed it fast."}
  ]
}

Dwa nawyki sprawiają, że to niezawodne. Po pierwsze, użyj słowa JSON i nazwij klucze w promptie, ponieważ tryb JSON gwarantuje składnię, a nie Twój schemat. Po drugie, odpowiedź nadal przychodzi jako ciąg w message.content, więc dodaj węzeł Code lub wyrażenie z JSON.parse() przed odczytaniem pól. W węźle OpenAI to samo przełączenie pojawia się jako opcja Format odpowiedzi w opcjach węzła.

Obsługa błędów 429 i innych

n8n wykonuje elementy równolegle, więc partia 50 wierszy może szybko osiągnąć limity. Pełny klucz pozwala na 8 równoległych zapytań i 300 zapytań na minutę; klucz próbny pozwala na 2 i 60. Gdy przekroczysz limit, API odpowiada HTTP 429 z kodem rate_limited (za dużo na minutę) lub concurrency (za dużo naraz). Przy tymczasowym przeciążeniu otrzymasz 429 z nagłówkiem Retry-After: 5.

Praktyczne ustawienia w n8n:

  • Otwórz węzeł, przejdź do Settings, włącz Retry On Fail, ustaw Max Tries na 3 lub 4, a Wait Between Tries na 5000 ms.
  • Umieść węzeł Loop Over Items (rozmiar partii 4 do 6) przed wywołaniem modelu, aby pozostać poniżej 8 równoległych zapytań.
  • W ustawieniach węzła Settings, opcja On Error może być ustawiona na kontynuację z wyjściem błędu, dzięki czemu jeden zły wiersz nie zatrzyma wykonania.

Aby lepiej zrozumieć oba rodzaje limitów, przeczytaj dokumentację API. Inne błędy są proste: 401 oznacza, że klucz jest nieprawidłowy lub w nagłówku brakuje słowa Bearer, a 404 zwykle oznacza literówkę w podstawowym URL lub dodatkową ścieżkę.

Lista rozwiązywania problemów

Większość niepowodzeń wynika z krótkiej listy przyczyn. Przejdź przez nią od góry do dołu, zanim zaczniesz podejrzewać usługę.

ObjawPrawdopodobna przyczynaNaprawa
401 przy zapisie lub uruchomieniuZły klucz lub brak Bearer w nagłówkuWklej klucz ponownie; w autoryzacji nagłówka wartość musi zaczynać się od Bearer
404Podstawowy URL ma literówkę lub dodatkową ścieżkęUżyj dokładnie https://api.onekeyllmapi.com/v1 w poświadczeniach
Model nie znalezionyID modelu nie jest wpisany jako uncensoredPrzełącz na opcję „Po ID” lub użyj węzła „Zapytanie HTTP”
429 z współbieżnościąWięcej niż 8 równoległych uruchomień (2 na kluczu próbnym)Przetwarzaj wsadowo z pętlą „Przetwarzaj elementy po kolei” i dodaj ponawianie
Błąd parsowania JSON w dalszej części potokuOdpowiedź jest ciągiem znaków lub prompt nie wymienił nazw kluczyWykonaj parsowanie z JSON.parse() i opisz klucze w systemowym promptcie

Kontaktując się z pomocą techniczną, dołącz nagłówek odpowiedzi X-Request-Id z nieudanej operacji. W n8n nagłówki możesz zobaczyć, włączając opcję Dołącz nagłówki odpowiedzi i status w ustawieniach węzła „Zapytanie HTTP”.

Testowanie przy niewielkim wydatku

Korzystaj z kredytu próbnego podczas budowania. Przy 2 równoległych zapytaniach i 60 zapytaniach na minutę klucz próbny jest wolny przy przetwarzaniu wsadowym, ale wystarczający do sprawdzenia poświadczenia, promptu i logiki parsowania. Przełącz się na pełny klucz, gdy przeniesiesz przepływ pracy do harmonogramu.

Koszt i rozsądny projekt przepływu pracy

Płacisz za zużycie: $0,15 za 1 mln tokenów wejściowych i $0,50 za 1 mln tokenów wyjściowych, pobierane z przedpłaconego kredytu. Przepływ pracy klasyfikujący 1000 e-maili dziennie, z 600 tokenami wejściowymi i 100 tokenami wyjściowymi na każdy, zużywa 0,6 mln tokenów wejściowych ($0,09) i 0,1 mln tokenów wyjściowych ($0,05), co daje około $0,14 dziennie. Nieudane lub odrzucone zapytania nie są rozliczane, więc ponawianie prób przy błędach nie podwaja rachunku. Szczegóły znajdziesz na stronie z cenami.

Trzymaj prompty krótkie, wysyłaj tylko pola potrzebne modelowi i ustaw max_tokens, gdy wiesz, że odpowiedź będzie krótka. Jeśli uruchamiasz również modele na własnym komputerze, przeczytaj artykuł o używaniu lokalnego LLM przez API w stylu OpenAI, który wykorzystuje te same ustawienia klienta.

Pytania i odpowiedzi

Które węzły n8n działają z niestandardowym URL bazowy?

Każdy węzeł korzystający z poświadczenia OpenAI może go użyć, ponieważ pole URL bazowy należy do poświadczenia. Jeśli węzeł nie udostępnia potrzebnego Ci parametru, użyj węzła „Zapytanie HTTP”.

Dlaczego lista modeli jest pusta lub błędna w n8n?

n8n ładuje i filtruje listę po swojej stronie. Wpisz ręcznie ID modelu uncensored lub użyj węzła „Zapytanie HTTP”, gdzie model jest po prostu polem w ciele żądania.

Czy mogę używać strumieniowania w n8n?

API obsługuje strumieniowanie przez SSE, ale większość węzłów n8n czeka na pełną odpowiedź przed przekazaniem danych. Dla przepływów pracy zwykłe wywołanie bez strumieniowania jest prostsze.

Jak sprawdzić saldo z przepływu pracy?

Wywołaj GET /v1/balance lub odczytaj nagłówek X-Balance-USD z dowolnej odpowiedzi i dodaj węzeł IF, który powiadomi Cię, gdy spadnie poniżej progu.

Twój klucz jest o jeden krok stąd

Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.