Wprowadzenie
Z-Image Spicy zamienia śmiały lub zwykły brief w jeden obraz o wymiarach, które sam ustawiasz. To osobny poziom bez cenzury, a nie ogólny model z poluzowanymi ustawieniami: między żądaniem a modelem nie ma flagi dojrzałości, deklaracji ani skanera.
Z-Image Spicy to poziom bez cenzury w linii Z-Image: dokładna szerokość i wysokość w pikselach do 1536, pole promptu bez limitu długości, opcjonalne rozwijanie promptu, domyślnie wyłączone, i żadnego filtra treści na całej drodze.
Najważniejsze funkcje
Osobny poziom do obrazów bez cenzury
Z-Image Spicy powstał z myślą o briefach wizualnych bez cenzury, a nie jako ogólna ścieżka z poluzowanymi ograniczeniami. Jasno określ zamierzony kontekst, obiekt i sposób potraktowania obrazu, a potem porównaj wynik z briefem i obowiązującymi zasadami.
Przemyślane sformułowania są częścią kierunku artystycznego
Przechowuj zatwierdzony brief razem z wybranym wynikiem. Dzięki temu późniejszy wariant może zmienić jedną decyzję wizualną, nie zmieniając po cichu intencji ani granic żądania.
Sprawdź kompozycję tam, gdzie zostanie użyta
Oceniaj obiekt, pozę, scenę i światło w miejscu, w którym obraz będzie użyty. Wiarygodna miniatura nie wystarczy, jeśli wybrany kadr traci wymaganą relację wizualną w docelowym formacie.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Bez limitu znaków. od 1 znaków |
width | Nie | Szerokość wyniku w pikselach, od 256 do 1536, ustawiana niezależnie od height. |
height | Nie | Wysokość wyniku w pikselach, od 256 do 1536, ustawiana niezależnie od width. |
enable_prompt_expansion | Nie | Przepisuje krótki prompt na dłuższy przed generowaniem. Domyślnie: |
seed | Nie | Podaj ten sam seed przy tym samym prompcie i tych samych wymiarach, żeby ustabilizować losowanie między dwoma przebiegami; dzięki temu da się je porównać, ale identyczny obraz n… |
Cennik
| Specyfikacja | Cena |
|---|---|
| $0.01235 / obraz |
| $0.0133 / obraz |
Zastosowania
Start od pisemnego briefu
Używaj tego endpointu do śmiałych lub zwykłych briefów, które wymagają dokładnego rozmiaru w pikselach. Ustaw width i height w zakresie od 256 do 1536, zostaw wyłączone enable_prompt_expansion, żeby sformułowania dotarły tak, jak je napisałeś, i przypnij seed, gdy look zadziała.
Prompty, które inne API obrazów odrzucają
Dosadne sformułowania, które filtrowane endpointy odrzucają, przechodzą bez zmian, a przy wyłączonym rozwijaniu nic ich po drodze nie przeredagowuje. Ten sam cykl życia zadania co przy każdym innym modelu tutaj: utwórz, odpytaj, pobierz z magazynu platformy.
Materiały o wymiarach dokładnie pod miejsce emisji
Grafika na kartę w 832x1216, nagłówek w 1536x512, kwadratowa miniatura w 512x512 — wszystko z jednego endpointu, wszystko natywnie, a nie przycięte, więc obiekt zostaje tam, gdzie oczekuje go układ.
Serie portretowe i modowe
Twarde światło przez żaluzje, zmięty len, koronka i jedwab w wybranym rozmiarze. Przypnij seed, gdy look zadziała, a potem przeprowadź tę samą osobę przez kilka wnętrz i strojów, by zbudować serię, która czyta się jak jedna sesja.
Wskazówki
Napisz pełny brief, rozszerzanie wyłączone
Nie ma limitu znaków, więc opisz w całości strój, kierunek światła, wygląd kliszy i paletę. Opublikowany kadr powstał z promptu: „Photograph of an adult woman lying on her side across rumpled white linen in a black lace bodysuit, morning sun through venetian blinds casting hard stripes across her skin and the sheets, one arm stretched above her head, eyes closed, calm and warm, medium format film look, soft grain, honey and cream palette.”
Podaj rozmiar kadru w pikselach
Ustaw szerokość i wysokość pod miejsce emisji, zamiast wybierać proporcję — 1024x1536 na portret, 1536x640 na nagłówek, 512x512 na miniaturę. Każdy bok przyjmuje dowolną wartość od 256 do 1536.
Dostosuj dołączony przykład
Zacznij od opublikowanego przykładu z height: 1536 i width: 1024. Wymień obiekt i kierunek kreatywny, ale zachowaj kontrakt wejścia tego trybu.
Photograph of an adult woman lying on her side across rumpled white linen in a black lace bodysuit, morning sun through venetian blinds casting hard stripes across her skin and the sheets, one arm stretched above her head, eyes closed, calm and warm, medium format film look, soft grain, honey and cream palette.
Prompt, z którego powstał kadr referencyjny tego endpointu, w 1024x1536 i z wyłączonym rozwijaniem, żeby sformułowania dotarły do modelu nietknięte. Pokazany obraz powstał na poziomie Turbo tej samej linii jako referencja stylu.
Sprawdź wynik, zanim zaczniesz iterować
1536 pikseli to sufit na bok, więc nie jest to poziom do materiałów w rozmiarze druku — generuj tutaj, a powiększaj gdzie indziej, jeśli potrzebujesz dużego kadru. Skrajne pary wymiarów wykraczają poza to, co model dobrze komponuje; trzymaj dłuższy bok najwyżej w okolicach dwukrotności krótszego, chyba że pusta przestrzeń jest zamierzona. Wyłączone enable_prompt_expansion to pewniejsza droga przy śmielszych briefach: włączone może uogólnić dokładne sformułowania, które wybrałeś. Ten endpoint nie ma negatywnego promptu ani wejścia obrazu.
Szybki start z API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/z-image-spicy/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"enable_prompt_expansion": false
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.












