Jak działa SpicyAPI

Jeśli dopiero zaczynasz, zacznij tutaj. Ta strona prostymi słowami wyjaśnia, co robi SpicyAPI, pomaga wybrać sposób korzystania, który ci odpowiada, i przedstawia garść pojęć, które pozostałe strony dokumentacji uznają za znane. Żeby ją przeczytać, nie musisz umieć programować.

Czym jest SpicyAPI

SpicyAPI daje ci jeden klucz API do modeli obrazu, wideo i tekstu od wielu różnych twórców, a opłaty pobiera za faktyczne użycie, w dolarach amerykańskich.

Bez niego korzystanie z kilku modeli AI oznacza zakładanie konta w każdej firmie osobno, poznawanie formatu żądań każdej z nich i doładowywanie każdego konta z osobna. Z SpicyAPI masz jedno konto i jedno saldo. Wybierasz model, wysyłasz prompt (oraz obraz referencyjny, jeśli model go przyjmuje) i dostajesz z powrotem obraz, wideo albo tekst. Przejście na inny model nie zmienia sposobu wysyłania żądania ani odbierania wyniku.

• Jeden klucz, wiele modeli. Każdego modelu obrazu i wideo używa się tak samo: wysyłasz zadanie, a potem odbierasz wynik. Modele tekstowe przyjmują dodatkowo formaty żądań oficjalnych bibliotek OpenAI, Anthropic i Google Gemini.
• Płacisz za użycie, w dolarach. W zależności od modelu cena dotyczy obrazu, sekundy wideo, żądania albo tokena. Nie ma subskrypcji ani systemu kredytów czy punktów: cena, którą widzisz, to kwota w dolarach, która schodzi z twojego salda. Nie ma też darmowego progu, więc przed pierwszą generacją trzeba doładować konto. Zobacz Rozliczenia.
• Gdy zadanie zostaje przyjęte, jego szacowany koszt jest blokowany na twoim saldzie. Jeśli zadanie się powiedzie, płacisz za to, co faktycznie zużyło – nigdy więcej niż zablokowana kwota. Nieudane lub wygasłe zadania zwykle zwalniają całą blokadę. Niektóre odmowy dotyczące treści są płatne według zaakceptowanej wyceny, wyłącznie gdy strona modelu wyraźnie wskazuje ten wyjątek. Sprawdź settled i cost, aby poznać ostateczną kwotę.
• Żadnego przełącznika treści do ustawiania. SpicyAPI nie wymaga w żądaniu flagi trybu treści i nie sprawdza treści poszczególnych żądań. To, co powstanie, zależy od samego modelu: niektóre modele odmawiają części żądań albo je łagodzą. Za to, jak wykorzystujesz wygenerowane materiały, odpowiadasz ty; zobacz Treści i odpowiedzialność za korzystanie.

SpicyAPI nie obsługuje Chin kontynentalnych, a ograniczenia obejmują też kilka innych regionów; szczegóły są na tej samej stronie zasad.

Co możesz stworzyć

W katalogu są też bardziej wyspecjalizowane zadania wideo, na przykład prowadzenie postaci ruchem zaczerpniętym z innego klipu albo przedłużanie istniejącego klipu. Modele z czasem przybywają i są wycofywane, więc o tym, co istnieje dzisiaj, zawsze rozstrzyga katalog na żywo.

Aktualne modele z ilustracjami, opisami i cenami zobaczysz na spicyapi.ai/explore. Tę samą listę możesz też pobrać bez konta i bez klucza jako surowy JSON, jeśli chcesz obejrzeć ją w terminalu:

curl "https://api.spicyapi.ai/console/v1/catalog/models?locale=en&strict=1"

Polecenie wypisze długi blok tekstu. Każdy model ma w nim pole modality (image, video albo text), listę tasks i cenę początkową price. Ta publiczna lista służy do przeglądania; gdy masz już klucz, listę modeli, które twój klucz faktycznie może wywołać, zwraca GET /api/v1/models. Zobacz hasło Katalog w słowniku.

Wybierz swoją drogę

Jest pięć sposobów korzystania. Wszystkie działają na tym samym koncie, z tym samym saldem, tymi samymi modelami i cenami, więc możesz zacząć od jednego, a później dołożyć kolejny.

Wypróbuj w przeglądarce

• Dla kogo: dla każdego, kto chce zobaczyć, co potrafi model, zanim cokolwiek postanowi. Niczego nie instalujesz i nie piszesz kodu.
• Czego potrzebujesz: przeglądarki internetowej. Dowolny model możesz otworzyć i wypełnić jego formularz bez konta. Żeby nacisnąć Uruchom, trzeba się zalogować i mieć środki na saldzie.
• Czy to kosztuje? Każde uruchomienie jest rozliczane jak wywołanie API. Nieudane lub wygasłe zadania zwykle zwalniają całą blokadę. Niektóre odmowy dotyczące treści są płatne według zaakceptowanej wyceny, wyłącznie gdy strona modelu wyraźnie wskazuje ten wyjątek. Sprawdź settled i cost, aby poznać ostateczną kwotę.
• Jak zacząć: otwórz spicyapi.ai/explore, wybierz model i skorzystaj z karty Playground na jego stronie. Zakończone uruchomienia pojawiają się też w sekcji Logi w konsoli.

Poproś swojego asystenta AI

• Dla kogo: dla osób, które już korzystają z asystenta AI, takiego jak Claude, Cursor, VS Code, Codex, Windsurf czy Gemini CLI, i chcą w rozmowie przeglądać modele, porównywać ceny oraz generować obrazy i wideo. Programiści sięgają po tę drogę także po to, żeby się rozeznać, zanim zaczną budować.
• Czego potrzebujesz: Node.js w wersji 22.13 lub nowszej, klucza API i aplikacji asystenta, która obsługuje MCP. Płatne kroki działają tylko w aplikacjach, które potrafią wyświetlić ci pytanie o potwierdzenie.
• Czy to kosztuje? Przeglądanie, wyceny i sprawdzanie wyników są bezpłatne. Uruchomienie albo ponowienie generacji najpierw się zatrzymuje i pokazuje cenę; asystent nie może odpowiedzieć na to pytanie za ciebie.
• Jak zacząć: serwer MCP daje asystentowi dostęp do akcji SpicyAPI. Agent Skill uczy asystenta programistycznego AI pisać integracje ze SpicyAPI w bezpieczny sposób i dobrze sprawdza się razem z serwerem MCP.

Wpisuj polecenia w terminalu

• Dla kogo: do porównywania cen, generowania obrazów i wideo na własnym komputerze z zapisem plików, powtarzania tej samej pracy albo uruchamiania prostego skryptu. Bez programowania.
• Czego potrzebujesz: terminala, Node.js w wersji 22.13 lub nowszej oraz klucza API zapisanego w zmiennej środowiskowej SPICY_API_KEY.
• Czy to kosztuje? Obciążyć cię mogą tylko spicyapi tasks create i spicyapi tasks retry, a oba polecenia pytają o zgodę, zanim cokolwiek zostanie pobrane.
• Jak zacząć: Narzędzie wiersza poleceń (CLI).

Buduj schematy z węzłów w ComfyUI

• Dla kogo: dla osób, które już pracują w ComfyUI i chcą mieć modele hostowane obok lokalnych węzłów: połączyć model obrazu z modelem wideo, dodać ścieżkę dźwiękową albo pozwolić modelowi czatu napisać prompt.
• Czego potrzebujesz: ComfyUI na swoim komputerze albo serwerze i klucza API. Modele SpicyAPI działają na naszych serwerach, więc nie potrzebujesz do nich karty graficznej.
• Czy to kosztuje? Każde uruchomienie jest rozliczane jak wywołanie API. Każdy węzeł pokazuje swoją stawkę, wycenia uruchomienie przed startem i może zatrzymać każde uruchomienie powyżej ustawionego przez ciebie limitu.
• Jak zacząć: Węzły ComfyUI.

Pisz kod

• Dla kogo: do wbudowania generowania obrazów, wideo albo tekstu we własną aplikację, backend strony internetowej lub potok przetwarzania danych.
• Czego potrzebujesz: kodu działającego na serwerze albo na twoim własnym komputerze, bo klucza API nigdy nie wolno umieszczać na stronie internetowej ani w aplikacji mobilnej. Oficjalne SDK są dla TypeScriptu (Node.js w wersji 22.13 lub nowszej), Pythona 3.11+, Go 1.23+, PHP 8.1+ i Javy 17+; z każdego innego języka możesz wywoływać HTTP API bezpośrednio.
• Czy to kosztuje? Każda przyjęta generacja jest płatna. Wyceny, odczyty katalogu i sprawdzanie zadań są bezpłatne.
• Jak zacząć: SDK dla TypeScriptu dla Node.js albo SDK dla Pythona, Go, PHP i Javy. Po zwykłe HTTP z przykładami w curl, Node.js, Pythonie i Go sięgnij do Szybkiego startu; modele czatu opisuje Tekst i streaming, a kompletny przykład od początku do końca – samouczek „z obrazu do wideo”.

Pojęcia, które spotkasz wszędzie

Do wypróbowania Playgroundu nic z tego nie jest potrzebne, ale każda inna strona zakłada, że to znasz. Każde pojęcie ma tu zdanie lub dwa, odnośnik do strony ze szczegółami i dłuższe, przystępne wyjaśnienie w słowniku.

Co się dzieje, gdy coś generujesz

1. Wybierasz model i wypełniasz jego dane wejściowe.
2. Opcjonalnie prosisz o wycenę: dokładną cenę, bezpłatnie.
3. Wysyłasz żądanie. SpicyAPI przyjmuje je jako zadanie, nadaje mu identyfikator i blokuje szacowany koszt na twoim saldzie.
4. Model pracuje w tle. Obrazy powstają zwykle w kilka sekund, wideo często w kilka minut.
5. Zadanie się kończy. Jeśli się powiodło, płacisz za to, co faktycznie zużyło – nigdy więcej niż zablokowana kwota. Nieudane lub wygasłe zadania zwykle zwalniają całą blokadę. Niektóre odmowy dotyczące treści są płatne według zaakceptowanej wyceny, wyłącznie gdy strona modelu wyraźnie wskazuje ten wyjątek. Sprawdź settled i cost, aby poznać ostateczną kwotę.
6. Odbierasz wynik – bo SpicyAPI wywoła twój serwer albo bo sam o niego zapytasz – i pobierasz plik. Linki do pobrania są tymczasowe, a pliki przechowujemy przez ograniczony czas, więc zapisz to, co chcesz zachować.

Identyfikator modelu

Każdy model ma dokładny identyfikator w postaci publisher/model/task. Kopiuj go z katalogu na żywo (GET /api/v1/models, spicyapi models list albo listModels()), a nie z pamięci czy ze strony internetowej: modele przybywają, są wstrzymywane i wycofywane. Przykłady kodu w tej dokumentacji mają MODEL_ID_FROM_CATALOG w miejscu, w którym powinien stać prawdziwy identyfikator. Katalog modeli i schematy · Słownik: identyfikator modelu

Zadania i ich stany

Generowanie obrazów i wideo jest asynchroniczne: wysłanie żądania i odebranie wyniku to dwa osobne kroki, połączone identyfikatorem zadania, który zaczyna się od job_. Zadanie przechodzi z queued do running i kończy się jako succeeded, failed albo expired; każdy stan inny niż queued i running jest ostateczny. Modele tekstowe odpowiadają natomiast na tym samym połączeniu, często słowo po słowie. Zadania asynchroniczne · Tekst i streaming · Słownik: stan zadania

Wycena

Wycena podaje cenę dokładnie twojego żądania, niczego nie uruchamiając i nie blokując środków. Jest ważna pięć minut. Jeśli wyślesz z nią żądanie, a cena albo samo żądanie w międzyczasie się zmieniły, wysyłka zostanie odrzucona, zamiast zostać rozliczona po innej kwocie. Wyceny i zgodność protokołów · Słownik: wycena

Klucz idempotentności

Etykieta, którą sam wybierasz dla jednej porcji pracy i wysyłasz razem z nią. Jeśli połączenie zostanie zerwane, a ty w ciągu 24 godzin wyślesz to samo żądanie z tą samą etykietą i tym samym kluczem API, dostaniesz z powrotem pierwotne zadanie, zamiast uruchamiać drugie i za nie płacić. CLI i serwer MCP tworzą taką etykietę za ciebie; w SDK albo w zwykłym HTTP podajesz własną. Idempotentność · Słownik: klucz idempotentności

Callbacki

Zamiast raz po raz pytać, czy zadanie już się skończyło, możesz podać w nim callBackUrl: publiczny adres HTTPS na twoim serwerze. Gdy zadanie się zakończy, SpicyAPI wyśle tam wynik z podpisem, dzięki któremu da się sprawdzić, że naprawdę pochodzi od SpicyAPI. Wielokrotne pytanie o stan, czyli odpytywanie (polling), w zupełności wystarcza, dopóki testujesz na własnym komputerze. Webhooki · Słownik: webhook

Jak długo przechowujemy wyniki

Link do pobrania wyniku działa około 20 minut; żeby dostać nowy, zapytaj o zadanie ponownie. Wygenerowane pliki przechowujemy najwyżej około 14 dni, przesłane pliki – jeden dzień, a tekst promptu – 30 dni. Wszystkie trzy terminy możesz skrócić, a treść pojedynczego zadania zniszczyć na żądanie. Zapisy rozliczeniowe przechowujemy znacznie dłużej. Pobierz wszystko, co chcesz zachować. Przechowywanie i usuwanie danych · Słownik: przechowywanie danych

Saldo i limity wydatków

Saldo to przedpłacone dolary amerykańskie. Każdy klucz API może mieć dodatkowo dzienny, miesięczny i łączny limit wydatków, który ustawiasz sam. Gdy saldo nie pokrywa zadania, dostajesz błąd 40201; gdy limit zostanie osiągnięty – 40202. Żaden z tych błędów nie tworzy zadania ani niczego nie pobiera. Rozliczenia · Uwierzytelnianie · Słownik: limit wydatków

Pierwszy raz, krok po kroku

Gdzie szukać pomocy

• Szybkie odpowiedzi: FAQ, Słownik, Rozwiązywanie problemów i Błędy.
• Czy usługa działa? status.spicyapi.ai.
• Porozmawiaj z nami: rozpocznij rozmowę na stronie Wsparcie w konsoli albo skorzystaj ze strony kontaktowej. Podaj request_id albo identyfikator zadania oraz czas w UTC. Nigdy nie wysyłaj swojego klucza API.

Co dalej