n8n

n8n to narzędzie do automatyzacji przepływów pracy. SpicyAPI daje mu modele obrazu, wideo, dźwięku i czatu za jednym API i jednym przedpłaconym saldem. Są trzy sposoby ich podłączenia i można je mieszać w jednym przepływie:

Wszystkie trzy korzystają z tego samego konta, klucza, modeli i cen. Przy generowaniu multimediów węzeł i szablony HTTP Request sprawdzają cenę przed wysłaniem żądania. Ponowne wysłanie tego samego przyjętego żądania multimedialnego z oryginalnym Idempotency-Key zwraca istniejące zadanie.

Na początek skorzystaj z przewodnika po obrazach NSFW w n8n: wybór modelu, edycja z referencją, pierwszy portret i przykładowe koszty. Poniższe kroki pozwalają połączyć workflow z Twoją instancją n8n.

Zanim zaczniesz

• Klucz API. Utworzysz go w konsoli; zaczyna się od sk-spicy-. Jeśli nie masz jeszcze konta, zobacz Przygotuj konto.
• Saldo. Przed pierwszym generowaniem dodaj środki w sekcji Billing konsoli. Workflow n8n, Studio i API korzystają z tego samego salda konta. Zobacz Rozliczenia, aby poznać sposób rozliczania opłat.
• Jeden klucz na automatyzację. Przepływy mogą działać znacznie częściej, niż człowiek klika. Utwórz osobny klucz dla n8n i ustaw na nim dzienny albo miesięczny limit wydatków, aby błąd w pętli miał pułap. Zobacz Uwierzytelnianie.
• n8n ma dostęp do api.spicyapi.ai. Wywołania wykonuje serwer n8n, a nie twoja przeglądarka.

Opcja 1: węzeł społeczności SpicyAPI

Węzeł ma otwarty kod (MIT) na github.com/spicyapi-ai/n8n-nodes-spicyapi i jest opublikowany w npm jako @spicyapi/n8n-nodes-spicyapi. Nie ma zależności uruchomieniowych i łączy się wyłącznie z api.spicyapi.ai.

Inne pakiety npm mają podobne nazwy, ale należą do niepowiązanych usług. Ten to pakiet o nazwie @spicyapi/n8n-nodes-spicyapi, a jego poświadczenie nazywa się SpicyAPI (spicyapi.ai) API.

Instalacja

cd ~/.n8n/nodes
npm install @spicyapi/n8n-nodes-spicyapi

Operacje

Generowanie obrazów, wideo i dźwięku

Trzy operacje Generate mają te same pola:

1. Model. Wybierz z listy, która pokazuje modele dla wybranego zasobu wraz z ceną wyjściową, albo wpisz identyfikator modelu ręcznie. Każdy model i jego parametry są wymienione na spicyapi.ai/models.
2. Prompt. Główne wejście tekstowe modelu. W modelach mowy to tekst do wypowiedzenia. Zostaw puste dla modeli, które nie mają promptu, takich jak powiększacze.
3. Media Inputs. Obrazy, wideo lub dźwięk, które model czyta. Wybierz pole (lista pokazuje pliki wejściowe wybranego modelu), a potem użyj pola binarnego z poprzedniego węzła albo adresu URL. Pliki binarne są przesyłane do SpicyAPI automatycznie. Dodaj kilka wejść dla tego samego pola, aby wypełnić pola listowe, takie jak obrazy referencyjne.
4. Model Parameters. Formularz wygenerowany ze schematu wybranego modelu: proporcje obrazu, rozdzielczość, czas trwania, seed i tak dalej. Pola, które zostawisz puste, nie są wysyłane, więc model użyje własnej wartości domyślnej.
5. Additional Parameters (JSON). Wszelkie inne pola wejściowe jako obiekt JSON. Zastępują pola powyżej.

Wynik zawiera rekord zadania (taskId, state, cost, settled, output). Przy włączonym Download Output, co jest wartością domyślną, pliki są też dołączane jako dane binarne w data, data_1 i tak dalej. Linki w output.assets[].url wygasają po około 20 minutach; kopie binarne nie.

Duże wideo są trzymane w pamięci, jeśli n8n nie przechowuje danych binarnych na dysku. Na self-hosted n8n ustaw N8N_DEFAULT_BINARY_DATA_MODE=filesystem, gdy pracujesz z wideo.

Kontrola kosztów i ponowienia

• Każdy element jest najpierw wyceniany. Węzeł prosi o wycenę. Jeśli wycena przekracza Max Cost per Item (USD), domyślnie $2, zatrzymuje się z błędem, zanim cokolwiek zostanie utworzone, i nic nie jest pobierane. Ustaw limit na 0, aby go usunąć.
• Zadanie jest tworzone z wycenioną ceną. Jeśli cena zmieni się między wyceną a wysłaniem, węzeł wycenia ponownie, sprawdza limit jeszcze raz i wysyła ponownie.
• Ponowienia nie pobierają opłaty dwa razy. Zobacz Limity kosztów i ponowienia.

Długo trwające zadania

Opcje i to, kiedy której użyć, opisuje sekcja Długo trwające zadania wideo.

Opcja 2: szablony HTTP Request

Dwa przepływy do zaimportowania używają wyłącznie wbudowanych węzłów n8n, więc działają na self-hosted n8n i na n8n Cloud, bez węzła społeczności. Znajdują się w folderze przykładów w repozytorium węzła.

Jak zbudowany jest szablon obrazu

Te same kroki działają dla każdego modelu medialnego, więc możesz skopiować ten wzorzec do własnego przepływu.

Kształty żądań i odpowiedzi opisują Zadania asynchroniczne, Wyceny i zgodność protokołów i Media. Pliki, które model czyta, takie jak obraz początkowy, mogą być publicznym adresem URL albo przesłanym plikiem spicy://.

Opcja 3: modele czatu w AI Agent i innych węzłach AI

Endpoint czatu SpicyAPI jest zgodny z OpenAI, więc mogą go używać własne węzły OpenAI w n8n. Nie potrzebujesz do tego węzła społeczności i działa to na n8n Cloud.

https://api.spicyapi.ai/v1

Warto wiedzieć:

• Lista modeli zawiera modele obrazu i wideo. Przy niestandardowym Base URL n8n pokazuje wszystko, co zwraca /v1/models, a lista SpicyAPI obejmuje wszystkie jego modele. Wybierz taki, który kończy się na /chat, albo wpisz identyfikator w trybie wyrażenia. Modele obrazu i wideo nie są modelami czatu i w agencie zawiodą.
• Use Responses API. Nowsze wersje węzła OpenAI Chat Model mogą wysyłać żądania do /v1/responses zamiast /v1/chat/completions. SpicyAPI obsługuje /v1/responses, ale nie previous_response_id. Jeśli żądanie agenta kończy się błędem przy włączonym Responses API, wyłącz Use Responses API w węźle.
• Ustawienia próbkowania. Jeśli ustawisz opcję, której model nie deklaruje, taką jak temperature w modelu z rozumowaniem, SpicyAPI ją ignoruje zamiast zgłosić błąd i wymienia zignorowane nazwy w nagłówku odpowiedzi X-Spicy-Ignored-Params; wartość spoza zakresu modelu jest zmieniana na najbliższą dozwoloną i wymieniana w X-Spicy-Adjusted-Params. Inne niezadeklarowane pola nadal zwracają 400.
• Narzędzia i wyjście JSON zależą od modelu. Sprawdź supported_parameters modelu w /v1/models.
• Modele z rozumowaniem wliczają tokeny rozumowania do max_tokens. Przy bardzo małej wartości, na przykład 20, model z rozumowaniem może zużyć cały budżet na myślenie i nie zwrócić tekstu (upstream_failed: „the output budget was spent on reasoning”). Zwiększ max_tokens albo obniż reasoning_effort. Wartości reasoning_effort różnią się zależnie od modelu.
• Streaming i koszt. Czat jest rozliczany według tokenów po wywołaniu. Szczegóły są na stronie Tekst i streaming, a przykłady żądań w Chat recipes.

Limity kosztów i ponowienia

Limity wydatków

• Użyj osobnego klucza dla n8n z dziennym albo miesięcznym limitem wydatków w konsoli oraz listą dozwolonych modeli, jeśli przepływ potrzebuje tylko kilku. Gdy limit zostanie osiągnięty, wywołanie kończy się błędem 40202 i nic za nie nie jest pobierane.
• Dla modeli medialnych najpierw wycenia się żądanie. Węzeł robi to za ciebie; szablony robią to węzłami Get Quote i If. Wycena to dokładna cena tego żądania, łącznie z dodatkami, takimi jak opłaty za każdy obraz referencyjny, więc kontrola ceny oparta na wycenie jest wiarygodna, a oparta na tabeli katalogu nie.
• Zwykłe niepowodzenia i wygasłe zadania zwalniają całą rezerwację. Niektóre odmowy treści są płatne wyłącznie wtedy, gdy strona modelu mówi o tym wprost. Ostateczną opłatę sprawdzisz w settled i cost; zobacz Rozliczenia.

Dlaczego ponowienie nie pobiera opłaty dwa razy

Każde wywołanie tworzące zadanie niesie Idempotency-Key. Jeśli ten sam klucz dotrze ponownie z tym samym żądaniem, SpicyAPI zwraca zadanie, które już utworzyło, zamiast tworzyć drugie, więc nie ma drugiej blokady ani opłaty. Ma to znaczenie w n8n, bo żądanie może zostać wysłane dwa razy bez twojego udziału: przez Retry On Fail na węźle albo przez przekroczenie czasu, gdy pierwsze żądanie faktycznie przeszło.

• Węzeł społeczności buduje klucz z wykonania, węzła, elementu i jego wejścia. Ponowienie węzła używa tego samego klucza. Nowe wykonanie, zmienione wejście albo kolejny przebieg pętli to nowa praca i dostaje nowy klucz.
• Szablony budują go z identyfikatora wykonania i indeksu elementu, na przykład n8n-<execution id>-<item index>. Jeśli kopiujesz ten wzorzec do pętli, dodaj do klucza licznik pętli, bo inaczej każdy przebieg zwróci zadanie z pierwszego przebiegu.
• Nie używaj wartości losowej, która zmienia się przy każdej próbie, takiej jak $now: sprawia, że każde ponowienie wygląda jak nowa praca.

Więcej w Idempotentność.

Długo trwające zadania wideo

Modele obrazu i dźwięku zwykle kończą w jednym żądaniu. Wideo może trwać minuty. Masz trzy sposoby, by sobie z tym poradzić, od najprostszego do najlżejszego dla n8n:

Jeśli węzeł przestanie czekać, zadanie nadal działa w SpicyAPI i jeśli się powiedzie, jest płatne. Pobierz je później przez Task > Get; nie wysyłaj go ponownie. Znajdziesz je też w sekcji Logs w konsoli.

Wyniki są przechowywane przez ograniczony czas, a linki do pobrania działają około 20 minut. Jeśli potrzebujesz ich na dłużej, zapisz pliki w przepływie, na przykład w magazynie w chmurze. Zobacz Przechowywanie i usuwanie danych.

Rozwiązywanie problemów

Błędy ze SpicyAPI kończą się request_id albo identyfikatorem zadania. Podaj go wsparciu, a żądanie da się dokładnie odnaleźć. Kody błędów wyjaśnia strona Błędy, a szerszą listę kontrolną znajdziesz w Rozwiązywanie problemów i odzyskiwanie.

Korzystanie z modeli podlega regulaminowi SpicyAPI oraz warunkom edycji n8n, której używasz.