Zmiany, które mają znaczenie przy budowaniu

Cztery nowe miejsca, które pomagają wybrać model. Wszystkie powstały z uruchomień na tej platformie. Rankingi, recenzje i arenę znajdziesz w nagłówku strony w sekcji Zestawienia, a bibliotekę promptów w sekcji Studio.

• Rankingi oceniają każdy model na dwóch osobnych skalach. Spicy Index (0–100) jest na razie wstępny: ocenia tylko możliwości, a jakość wyników dojdzie, gdy będą gotowe nasze testy jakości i zbierze się dość głosów na arenie. Freedom Score (0–100) mierzy, jak daleko model sprawdzalnie przechodzi po naszej drabinie testów treści. Skale nigdy się nie mieszają, a cena, szybkość i niezawodność stoją obok jako surowe pomiary. Są rankingi wideo, obrazów, LLM, modeli bez cenzury, najlepszego stosunku ceny do jakości i szybkości; na 26 września sklasyfikowanych jest 53 modeli na podstawie 1672 uruchomień testowych, a wyniki są przeliczane codziennie.
• Recenzje: na razie osiem — MiniMax H3, MiniMax H3 Spicy, Seedance 2.5, Seedance 2.5 Spicy, Wan 3.0, Seedream 5.0 Pro, Z-Image Spicy i Grok 4.7. Każda pokazuje prawdziwe wyniki, raport z testów, koszt użytecznego wyniku i jasną rekomendację.
• Ślepa arena: dwa anonimowe wyniki, obraz albo wideo, z tego samego promptu. Wybierz wynik, który wolisz zachować, a potem zobacz, które modele je zrobiły. Głosy zalogowanych użytkowników wyznaczają oceny Bradleya–Terry'ego z przedziałami 95%, odświeżane co godzinę; modele o nakładających się przedziałach dzielą miejsce. Miejsca pojawią się, gdy zbierze się dość głosów; do tego czasu modele są wymienione według wydawcy.
• Biblioteka promptów: 176 promptów do modeli wideo i obrazów, każdy z wynikiem, który naprawdę dał. Filtruj po modelu, zadaniu, scenie albo ruchu kamery, a potem skopiuj prompt lub otwórz go w playgroundzie z wypełnionymi wszystkimi ustawieniami.

Metodologia jest publiczna i wersjonowana. Sprzedajemy dostęp do każdego modelu, który oceniamy, więc ta strona wyjaśnia też, jak nie pozwalamy, by to wpływało na wyniki.

Cztery zmiany w działaniu zadań. Dwie mogą wymagać zmian po twojej stronie: jeśli zakładasz, że identyczne żądania dają identyczne wyniki, wysyłaj seed; jeśli rozgałęziasz logikę po kodach błędów, obsłuż 40310.

Nieudane uruchomienie najpierw próbujemy na innej trasie. Wiele modeli jest tu dostępnych przez więcej niż jedną trasę. Od 23 września, gdy uruchomienie zawiedzie po przyjęciu, a inna trasa obsługuje ten sam model z tymi samymi ustawieniami, uruchamiamy je tam, zanim zgłosimy błąd, o ile zadaniu zostało jeszcze czasu. Płacisz raz, za wynik, który dostajesz. Błędów, które powtórzyłyby się wszędzie, na przykład odmowy z powodu praw autorskich, nie ponawiamy.

Odmowy podają przyczynę i rozwiązanie. Gdy model blokuje wynik z powodu możliwego naruszenia praw autorskich albo twarzy prawdziwej osoby, errorMessage mówi teraz, o który przypadek chodzi i co spróbować:

• W wideo przyczyną jest najczęściej wygenerowana ścieżka dźwiękowa: ustaw generate_audio: false, usuń dźwięk referencyjny i nie wymieniaj w prompcie prawdziwych utworów ani wykonawców.
• W obrazach zwykle chodzi o znaną postać, logo lub dzieło w prompcie albo w obrazie referencyjnym.
• Niektóre modele nie przyjmują twarzy prawdziwych osób w obrazach referencyjnych. Komunikat to mówi i proponuje inny model albo postać rysunkową.

errorCode pozostaje content_rejected, opłata wraca na konto, a komunikat, jak każdy inny błąd, jest w języku błędów API ustawionym na koncie.

Losowy seed, gdy pominiesz seed. Od 24 września w modelach, które przyjmują seed, żądanie bez niego dostaje losowy seed, zwracany w input zadania. Dwa identyczne żądania nie dają już tego samego wyniku. Żeby uruchomienia dało się porównywać, odeślij zwrócony seed; stały seed nie gwarantuje jednak identycznego wyniku. Kilka modeli zmienia seed, ale go nie zwraca. Seed wysłany przez ciebie jest zawsze używany bez zmian.

40310 dla kont z niezweryfikowanym adresem e-mail. Klucze takich kont dostawały dotąd ogólny 403. Od 25 września dostają kod biznesowy 40310 z komunikatem, żeby otworzyć link weryfikacyjny albo zamówić nowy w konsoli. Klucz zaczyna działać, gdy tylko adres zostanie zweryfikowany.

Udostępniliśmy pięć oficjalnych SDK, a obok nich CLI, serwer MCP, Agent Skill oraz proxy, dzięki któremu klucz nie musi trafiać do aplikacji klienckiej. Wszystkie realizują te same cztery kroki: wycena, utworzenie zadania z kluczem idempotencji, oczekiwanie, odbiór.

• Do drzewa zależności nie trafia prawie nic. Python i Go korzystają wyłącznie z biblioteki standardowej, PHP również obywa się bez bibliotek, a Java przynosi dokładnie jedną: Jacksona.
• Cały przepływ asynchroniczny, nie tylko wywołanie HTTP: budżet oczekiwania przy tworzeniu zadania, trzyetapowe wysyłanie własnych obrazów i wideo oraz weryfikacja podpisu webhooków.
• @spicyapi/cli przegląda katalog, wycenia zlecenie przed wydaniem pieniędzy i pobiera gotowe wyniki prosto z terminala. @spicyapi/mcp daje te same możliwości Claude Code, Codeksowi, Cursorowi i każdemu klientowi MCP, pytając przed każdym płatnym krokiem. Agent Skill instaluje się poleceniem npx skills add Spicy-API/spicy-skill i uczy asystenta programistycznego właściwej kolejności działań.
• @spicyapi/proxy zostawia klucz na waszym serwerze. Klucz wkompilowany w aplikację przeglądarkową, mobilną albo desktopową jest kluczem publicznym; ten pakiet to przeskok po stronie serwera, który przechowuje go zamiast aplikacji.

Wszystkie pięć to otwarte oprogramowanie na licencji MIT. Przewodniki: docs.spicyapi.ai

Dwa sposoby, żeby nie pisać już pętli odpytywania. Oba są dostępne.

Budżet oczekiwania przy tworzeniu zadania. Dopiszcie ?wait=<sekundy> do createTask, a utrzymamy połączenie otwarte, dopóki zadanie nie osiągnie stanu końcowego, i odpowiemy pełnym rekordem zadania — w tej samej postaci, którą zwraca recordInfo.

• Budżet się kończy: dostajecie zwyczajne 202, identyczne jak bez tego parametru, i odpytujecie dalej sami.
• Połączenie pada: dla zadania nic się nie zmienia. Działa dalej i jest rozliczane normalnie.
• Górna granica to 60 sekund. Większe wartości są przycinane, a nie odrzucane, a wartość o błędnym formacie jest ignorowana, a nie odrzucana — literówka w parametrze optymalizacyjnym nie powinna wywracać generowania, które i tak by się udało.

Warto stosować na endpointach kończących się w kilka sekund, czyli przy większości pracy z obrazem i edycją. Modele wideo zwykle liczą się minutami, więc budżet po prostu wygaśnie i i tak skończy się na odpytywaniu.

Webhookowe endpointy na poziomie konta. Zarejestrujcie adres URL raz, razem z listą interesujących was zdarzeń, a każde pasujące zadanie trafi właśnie tam — nie trzeba już podawać adresu zwrotnego przy każdym zadaniu. Konto mieści do 16 endpointów, każdy z własnym sekretem podpisu. Odpowiedź 410 Gone z waszego serwera natychmiast wyłącza dany endpoint, zamiast dobijać się pod adres, który właściciel zamknął. Na razie endpointy obsługuje wyłącznie API; w panelu nie ma jeszcze dla nich ekranu.

Szczegóły: zadania · webhooki

403 przykłady pokrywają obecnie 117 ze 120 wywoływalnych endpointów. Każdy z nich to zadanie faktycznie wykonane na tej platformie — nie grafika koncepcyjna ani kadr pożyczony z karty modelu. Do każdego dołączone są trzy rzeczy:

• Gotowy plik, serwowany z naszego własnego CDN-a, w oryginalnych proporcjach.
• Kompletny obiekt wejściowy, który go stworzył: prompt, rozmiar, czas trwania, wszystkie parametry — gotowy do skopiowania wprost do waszego wywołania.
• Komentarz we wszystkich dziesięciu językach interfejsu: dlaczego wybrano takie wejście, pod jakie proporcje pisano kompozycję, który parametr odpowiada za efekt i co zmienić w pierwszej kolejności.

Na stronie modelu układają się w ścianę wyników, którą da się ogarnąć jednym spojrzeniem; przez API wracają w polu examples odpowiedzi GET /console/v1/catalog/models/{slug}.

Do tej pory wybór modelu oznaczał czytanie tabeli parametrów i wyobrażanie sobie rezultatu. Teraz widać, co endpoint naprawdę produkuje, i można zacząć od wejścia, o którym wiadomo, że na nim działa.

Przejrzyj katalog