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:
- Wklej swój klucz w pole API Key.
- Pozostaw pole Organization ID puste.
- Zamień domyślne Base URL na
https://api.onekeyllmapi.com/v1. Zachowaj/v1na końcu i nie dodawaj/chat/completions. - 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.
- Dodaj węzeł Manual Trigger.
- 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.
- 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. - 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ę.
| Objaw | Prawdopodobna przyczyna | Naprawa |
|---|---|---|
| 401 przy zapisie lub uruchomieniu | Zły klucz lub brak Bearer w nagłówku | Wklej klucz ponownie; w autoryzacji nagłówka wartość musi zaczynać się od Bearer |
| 404 | Podstawowy URL ma literówkę lub dodatkową ścieżkę | Użyj dokładnie https://api.onekeyllmapi.com/v1 w poświadczeniach |
| Model nie znaleziony | ID modelu nie jest wpisany jako uncensored | Przełą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 potoku | Odpowiedź jest ciągiem znaków lub prompt nie wymienił nazw kluczy | Wykonaj 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.
