Krótka odpowiedź: wybierz endpointy do krótkiej listy na podstawie zadania oraz etykiety treści, którą nadaje każdemu z nich bieżący katalog, a potem przetestuj własne briefy kilka razy każdy i licz wyniki użyteczne, a nie zakończone zadania. Endpoint o etykiecie „łagodzący” zwraca zadanie zakończone powodzeniem i opłacone, z obrazem przygaszonym, więc zielony status niczego nie dowodzi. A SpicyAPI nie skanuje ani żądań, ani wyników, więc kontrole, które trzymają Twój produkt w granicach prawa i Twoich własnych reguł, budujesz sam. Etykiety i ceny poniżej pochodzą z początku października 2026; źródłem prawdy jest bieżący katalog API generowania obrazów bez cenzury.
Co etykiety treści oznaczają dla integracji
Każdy endpoint obrazów w katalogu ma jedną z czterech etykiet. Spośród 59 aktywnych endpointów obrazów w katalogu 40 ma etykietę bez cenzury, 3 — łagodzącą, 12 — filtrującą, a 4 nie ma żadnej etykiety (usuwanie tła, skalowanie w górę i podobne narzędzia).
| Etykieta | Co API robi z briefem wykraczającym poza limity modelu | Co musisz obsłużyć sam |
|---|---|---|
| Bez cenzury | Model deklaruje, że nie ma filtra treści, a SpicyAPI przekazuje żądanie bez dodawania skanowania. | Twoje własne kontrole przed wywołaniem i po nim. |
| Łagodząca | Zadanie kończy się powodzeniem i jest fakturowane, ale obraz wraca przygaszony. | Sprawdź wynik; kod statusu Ci tego nie pokaże. |
| Filtrująca | Model odmawia. Zadanie kończy się jako failed z errorCode: "content_rejected". | Pokaż neutralny komunikat i nie powtarzaj żądania bez zmian. Odmowa zwykle nie jest naliczana; niektóre strony modeli twierdzą, że jest, więc przeczytaj stronę. |
| Bez etykiety | Niezmierzone. | Nie zakładaj niczego w żadną stronę. |
Etykieta należy do endpointu, a nie do rodziny: Wan 2.7 Pro tekst na obraz ma etykietę łagodzącą, a jego endpoint edycji — bez cenzury, więc benchmark mieszający oba porównuje dwie różne obietnice. Etykieta jest też wyłącznie informacyjna: mówi, czego się spodziewać, a nie co jest gwarantowane.
Ponieważ nie ma skanowania na poziomie platformy, bezwarunkowe reguły z polityki treści i użytkowania stają się zadaniem Twojego produktu: nic seksualizowanego z udziałem nieletniego, żadnego intymnego przedstawienia rozpoznawalnej osoby realnej bez udokumentowanej zgody (w tym podmiany twarzy), żadnego podszywania się. Przed wywołaniem umieść kontrole wieku, rejestry zgody dla każdych danych wejściowych z osobą realną oraz sposób zgłaszania treści przez użytkowników. Dłuższa wersja jest w artykule „Building on a less restrictive model” (na razie tylko po angielsku).
Krótka lista według zadania, potem etykiety i ceny
Napisz jedno zdanie o swoim pierwszym przepływie pracy, na przykład „edytuj licencjonowane zdjęcie mody, zmieniając wyłącznie tło”. Powie Ci, którego zadania potrzebujesz; zadania to osobne wpisy katalogu z osobnymi polami. Ceny to najniższa cena „od” na danej stronie; rozdzielczość, referencje i opcje zmieniają kwotę końcową.
| Endpoint | Zadania | Etykieta | Od | Do czego strona go podaje |
|---|---|---|---|---|
| Qwen Image 3.0 | tekst na obraz, edycja | Bez cenzury | 0,03 $ | Edycja od jednego do trzech obrazów referencyjnych, w tym przepisanie tekstu już obecnego w kadrze |
| Seedream 5.0 Pro | tekst na obraz, edycja | Bez cenzury | 0,036 $ | Złożenie kadru z maksymalnie dziesięciu obrazów referencyjnych, każdy z nazwaną rolą |
| Z-Image Spicy | tekst na obraz | Bez cenzury | 0,0124 $ | Tekst na obraz w dokładnych wymiarach w pikselach, rozwijanie promptu wyłączone, chyba że je włączysz |
| Prefect Pony XL | tekst na obraz | Bez cenzury | 0,015 $ | Klatki still anime i ilustracji z promptów w stylu tagów |
| Wan 2.7 Pro | tekst na obraz, edycja | Łagodząca (tekst na obraz) | 0,075 $ | Jeden obraz na dużym płótnie, domyślnie 2k, do 4k; filtrowanie różni się zależnie od endpointu |
| Krea 2 Medium | tekst na obraz | Łagodząca | 0,03 $ | Jeden obraz z długiego promptu w pięciu typowych proporcjach, domyślnie PNG; bez seeda, by skorygować nietrafiony wynik |
| Nano Banana 2 | tekst na obraz, edycja | Filtrująca | 0,036 $ | Edycja z użyciem maksymalnie czternastu obrazów referencyjnych, od 0,5K do 4K |
To jest krótka lista, nie ranking. Dla produktu dla dorosłych zacznij od wierszy bez cenzury pasujących do Twojego zadania. Wiersz łagodzący działa tylko wtedy, gdy Twoje briefy mieszczą się dobrze w jego granicach; wiersz filtrujący pasuje do połowy SFW produktu mieszanego. Prefect Pony XL oczekuje tagów rozdzielonych przecinkami i siedmiu stałych rozmiarów, więc podawaj mu prompty w stylu tagów, a nie zdaniowe briefy pisane pod model fotorealistyczny.
Każda strona modelu linkuje raport z testów, na przykład Z-Image Spicy i Seedream 5.0 Pro, z prawdziwymi wynikami od sugestywnych po intensywne sceny dla dorosłych oraz z czasem mediany (około 18 s dla Z-Image Spicy, około 70 s dla Seedream 5.0 Pro). Przeczytaj je najpierw, a potem zmierz czas oczekiwania od utworzenia zadania do wyniku możliwego do pobrania, mierzony z Twoich własnych serwerów.
Testuj własne briefy, a nie grzeczną podmianę
Pisz briefy z intensywnością, którą Twój produkt naprawdę będzie oferował, z wymyślonymi dorosłymi postaciami lub z danymi, na których użycie masz zgodę. Zestaw podmian SFW może przejść przez endpoint łagodzący, bo łagodzenie ujawnia się dopiero wtedy, gdy brief wykroczy poza granice modelu. Trzymaj briefy w prywatnym repozytorium testów, a nie w zgłoszeniach ani w dokumentach publicznych. Uruchom każdą fixture trzy razy: wystarczy, by ujawnić niestabilność, i wystarczająco tanio, by powtórzyć po zmianie.
| ID | Fixture | Co Ci mówi |
|---|---|---|
| 01 | Twój najczęstszy brief w jego normalnej intensywności | Wyjściowy odsetek wyników użytecznych |
| 02 | Ten sam brief w najwyższej intensywności, którą dopuścisz | Czy endpoint odmawia, łagodzi lub dostarcza u góry Twojego zakresu |
| 03 | Trzy nieszkodliwe parafrazy fixture 01 | Czy zmiana sformułowania odwraca wynik |
| 04 | Autoryzowany obraz źródłowy z jedną nazwaną edycją (tło, kolor ubrania, oświetlenie) | Czy edycja dochodzi do skutku i czy fragmenty chronione przetrwają |
| 05 | Ta sama edycja z dwoma obrazami referencyjnymi, każdy z nazwaną rolą | Czy dodatkowe referencje pomagają, czy rozmywają wynik, i co dodają do ceny |
| 06 | Format kadru, który będziesz publikować (na przykład 9:16) | Czy kompozycja utrzymuje się w Twoim rzeczywistym rozmiarze |
| 07 | Brief, który Twoja własna aplikacja musi zatrzymać | Że Twoja kontrola wstępna go blokuje i żadne zadanie nie powstaje |
| 08 | Żądanie ucięte tuż po wysłaniu | Że Twój klient odzyskuje istniejące zadanie, zamiast płacić dwa razy |
Ustal pisemną regułę zaliczania przed uruchomieniem: podmiot i kompozycja zgadzają się z briefem, chronione obszary edycji pozostają niezmienione, intensywność nie jest łagodniejsza niż żądana i nie ma wady anatomii ani literowania, którą zauważyłby klient. Zapisuj dla każdego kandydata dwie liczby: odsetek wyników użytecznych (wyniki spełniające regułę podzielone przez zakończone zadania) i koszt jednego użytecznego wyniku (całkowite wydatki podzielone przez tę samą liczbę), co czyni porównywalnym tańszy, ale łagodzący endpoint z droższym, lecz niezawodnym. Do pełniejszej rubryki oceny użyj przewodnika po benchmarku API obrazów.
Najpierw sprawdź jedną fixture w Playground
- Otwórz stronę endpointu z krótkiej listy, na przykład Z-Image Spicy tekst na obraz, i zaloguj się kontem z zasilonym saldem. Formularz znajduje się na stronie.
- Wklej fixture 01 w Prompt i ustaw rozmiar kadru (Width i Height tutaj; inne endpointy używają pola proporcji lub rozmiaru).
- Odczytaj cenę pod formularzem, naciśnij Run i powtórz uruchomienie jeszcze dwa razy, aby zobaczyć rozrzut.
- Uruchom fixture 02 i 03 w ten sam sposób, a potem oceń każdy wynik swoją regułą zaliczania, zanim napiszesz jakikolwiek kod.
Klatki filmu przechodzące przez projektor i tworzące jedną gotową klatkę.
Potem skryptuj ten sam test
Gdy fixture zachowuje się w Playground zgodnie z oczekiwaniami, uruchom ją z pliku. Wycena jest bezpłatna: weryfikuje dokładne ciało żądania, które byś wysłał, niczego nie tworzy i nie blokuje środków.
spicyapi tasks quote --model alibaba/z-image-spicy/text-to-image --input-file fixture-01.jsonUtwórz zadanie z tego samego pliku poleceniem tasks create; ponowienia, odpytywanie i wyniki opisuje dokumentacja zadań oraz dokumentacja CLI.
Albo niech wykona to Agent. Dzięki serwerowi MCP asystent wycenia żądanie przez spicyapi_task_quote, a npx skills add spicyapi-ai/spicy-skill instaluje Agent Skill, który każe mu czytać bieżący schemat przed każdym wywołaniem.
Pięć faktów zmienia sposób zbudowania platformy testowej:
- Wycena jest najtańszym testem. Przepuść przez nią każdą fixture przed pierwszym płatnym uruchomieniem i ponownie sprawdzaj etykietę każdego endpointu w CI, bo etykiety mogą się zmieniać.
- Każdy endpoint przyjmuje tylko własne nazwy pól; nieznane pola są odrzucane. Sam rozmiar wyjściowy zapisuje się na trzy sposoby: Z-Image przyjmuje
aspect_ratio, Prefect Pony XL pojedynczesize, a Z-Image Spicywidthiheight. Zbuduj osobny adapter dla każdego endpointu z jego bieżącego schematu, a nie jedno wspólne żądanie. - Obrazy referencyjne mogą podnieść cenę. Każdy ponad pierwszy dokłada się do wyceny Seedream 5.0 Pro, więc wyceń dokładne ciało żądania z rzeczywistą liczbą obrazów referencyjnych.
succeedednie znaczy „użyteczny”. Oznacza tylko, że model coś zwrócił; oceń każdy wynik swoją regułą zaliczania — tam właśnie wychwycisz obrazy przygaszone. Odmowy zwykle nie są naliczane.- Tworzenie, które przekroczyło limit czasu, może nadal istnieć. Wyślij je ponownie z tym samym kluczem idempotencji, zamiast płacić dwa razy; to właśnie sprawdza fixture 08.
Linki do pobierania i wygenerowane pliki wygasają, więc kopiuj zatwierdzone obrazy do własnej pamięci razem z referencją zadania obok nich (artykuł o retencji mediów). Co do odpytywania kontra webhookom, zobacz przewodnik „Polling versus webhooks” (na razie tylko po angielsku).
Jak podjąć decyzję
Odrzuć endpointy, które nie publikują zadania potrzebnego Twojemu pierwszemu przepływowi pracy. Odrzuć te, które nie przechodzą fixture 07 i 08. Pozostałe porównuj na tych samych briefach według odsetka wyników użytecznych i kosztu jednego użytecznego wyniku. Preferuj endpoint bez cenzury z najlepszym odsetkiem dla Twojego zakresu intensywności; endpoint łagodzący lub filtrujący zostaw tylko tam, gdzie jego granice pasują do briefu, i powiedz o tym w tekstach produktu, zamiast obiecywać „wszystko”. Awaryjny wariant musi przejść te same fixture.
Najczęstsze pytania
Czy endpoint bez cenzury jest automatycznie lepszym wyborem dla mojego API?
Nie. Oznacza brak zadeklarowanego filtra, a nie to, że pójdzie za Twoim briefem ani że kosztuje mniej za każdy użyteczny obraz.
Skąd mam wiedzieć, że endpoint łagodzący przygaszył mój obraz?
Porównaj fixture 02 z fixture 01: endpoint łagodzący zachowuje podmiot, ale traci intensywność, o którą prosiłeś. Nic w odpowiedzi zadania tego nie sygnalizuje.
Czy odmowa coś kosztuje?
Zwykle nie: nieudane zadania zwalniają całą blokadę. Niektóre strony modeli twierdzą, że pewne odmowy są naliczane, więc sprawdź koszt zadania, zanim założysz, że było bezpłatne.
Czy mogę testować na prawdziwych zdjęciach klientów?
Nie na początku. Używaj danych autoryzowanych lub syntetycznych. Każde wejście z udziałem realnej osoby wymaga udokumentowanej zgody na konkretną edycję i dystrybucję, a wszystko, co dotyczy nieletniego, jest zawsze niedozwolone.
Czy ukończone zadanie znaczy, że mogę pokazać obraz użytkownikom?
Nie. Ukończone zadanie znaczy tylko, że model coś zwrócił. Sprawdź je swoją regułą zaliczania, która wyłapie też wynik łagodzony, i skopiuj zatwierdzone obrazy do własnej pamięci przed dostarczeniem.
Jak często powinienem powtarzać kontrole?
Przed startem i po każdej zmianie modelu, etykiety, ceny lub schematu.
