Einführung
Z-Image Spicy setzt einen unzensierten oder gewöhnlichen Brief in ein einzelnes Bild in Maßen um, die Sie selbst festlegen. Es ist eine eigene unzensierte Stufe, kein Allzweckmodell mit gelockerten Einstellungen: Zwischen Anfrage und Modell gibt es kein Reife-Flag, keine Erklärung und keinen Scanner.
Z-Image Spicy ist die unzensierte Stufe der Z-Image-Reihe: exakte Pixelbreite und -höhe bis 1536, ein Prompt-Feld ohne Längengrenze, eine optionale Prompt-Erweiterung, die standardmäßig aus ist, und nirgends auf dem Weg ein Inhaltsfilter.
Wichtige Funktionen und Highlights
Eine eigene Stufe für unzensierte Bilder
Z-Image Spicy ist für unzensierte Bild-Briefs gedacht, nicht als gelockerte Allzweckroute. Machen Sie den beabsichtigten Kontext, das Motiv und die Bildbehandlung klar und prüfen Sie das Ergebnis dann am formulierten Brief und an den geltenden Richtlinien.
Bewusste Formulierungen bleiben Teil der Art Direction
Bewahren Sie den freigegebenen Brief zusammen mit dem ausgewählten Ergebnis auf. So kann eine spätere Variante eine visuelle Entscheidung ändern, ohne stillschweigend die Absicht oder die Grenzen der Anfrage zu verschieben.
Die Komposition im geplanten Einsatz prüfen
Beurteilen Sie Motiv, Pose, Szene und Licht dort, wo das Bild verwendet wird. Ein plausibles Vorschaubild genügt nicht, wenn das ausgewählte Bild bei der Auslieferung die geforderte Bildbeziehung verliert.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Keine Zeichengrenze. mindestens 1 Zeichen |
width | Nein | Ausgabebreite in Pixeln, 256 bis 1536, unabhängig von height gesetzt. Halten Sie die lange Seite bei etwa der doppelten kurzen Seite, sofern die Leerfläche nicht Absicht ist. |
height | Nein | Ausgabehöhe in Pixeln, 256 bis 1536, unabhängig von width gesetzt. |
enable_prompt_expansion | Nein | Schreibt einen kurzen Prompt vor der Generierung zu einem längeren um. Standardwert: |
seed | Nein | Denselben seed mit demselben Prompt und denselben Maßen senden, damit der Zug zwischen zwei Läufen gleich bleibt; das macht sie vergleichbar, garantiert aber kein identisches Bild. |
Preis
| Spezifikation | Preis |
|---|---|
| $0.01235 / Bild |
| $0.0133 / Bild |
Anwendungsfälle
Mit einem schriftlichen Brief beginnen
Nutzen Sie diesen Endpunkt für unzensierte oder gewöhnliche Briefs, die ein exaktes Pixelmaß brauchen. Setzen Sie width und height zwischen 256 und 1536, lassen Sie enable_prompt_expansion aus, damit der Wortlaut so ankommt, wie er geschrieben ist, und fixieren Sie seed, sobald ein Look sitzt.
Prompts, die andere Bild-APIs ablehnen
Unzensierte Formulierungen, die gefilterte Endpunkte zurückweisen, werden unverändert weitergegeben, und bei ausgeschalteter Erweiterung formuliert sie unterwegs niemand um. Derselbe Task-Lebenszyklus wie bei jedem anderen Modell hier: erstellen, abfragen, aus dem Plattformspeicher abholen.
Assets mit exakten Maßen für die Platzierung
Kartenmotiv in 832x1216, ein Header in 1536x512, ein quadratisches Vorschaubild in 512x512 – alles vom selben Endpunkt, alles nativ statt beschnitten, sodass das Motiv dort bleibt, wo das Layout es erwartet.
Porträt- und Modeserien
Hartes Licht durch Jalousien, zerwühltes Leinen, Spitze und Seide in einer Größe Ihrer Wahl. Fixieren Sie einen Seed, sobald ein Look sitzt, und führen Sie dann dieselbe Person durch mehrere Räume und Outfits, um eine Serie zu bauen, die wie ein Shooting wirkt.
Prompt-Leitfaden und Praxistipps
Das vollständige Briefing schreiben, Erweiterung aus
Es gibt keine Zeichengrenze; beschreiben Sie Garderobe, Lichtrichtung, Film-Look und Farbpalette also vollständig. Das veröffentlichte Standbild entstand aus: „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.“
Das Bild in Pixeln benennen
Setzen Sie Breite und Höhe für die Platzierung, statt ein Seitenverhältnis zu wählen – 1024x1536 für ein Hochformat, 1536x640 für einen Header, 512x512 für ein Vorschaubild. Beide Seiten akzeptieren alles von 256 bis 1536.
Das mitgelieferte Beispiel anpassen
Beginnen Sie mit dem veröffentlichten Beispiel mit height: 1536 und width: 1024. Ersetzen Sie Motiv und kreative Richtung, behalten Sie aber den Eingabevertrag dieses Modus bei.
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.
Der Prompt hinter dem Referenzbild dieses Endpunkts, in 1024x1536 und mit ausgeschalteter Erweiterung, damit der Wortlaut unverändert beim Modell ankam. Das gezeigte Bild entstand als Stilreferenz auf der Turbo-Stufe derselben Reihe.
Das Ergebnis prüfen, bevor Sie iterieren
1536 Pixel sind die Obergrenze pro Seite; für ein Druckformat ist diese Stufe also nicht gedacht – erzeugen Sie hier und skalieren Sie anderswo hoch, wenn ein großes Bild nötig ist. Extreme Seitenverhältnisse gehen über das hinaus, was das Modell gut komponiert; halten Sie die lange Seite bei höchstens etwa dem Doppelten der kurzen, sofern Leerraum nicht gewollt ist. enable_prompt_expansion ausgeschaltet zu lassen, ist bei unzensierten Briefs der verlässlichere Weg: Eingeschaltet kann es den genauen Wortlaut verallgemeinern, den Sie gewählt haben. Einen negativen Prompt und eine Bildeingabe gibt es auf diesem Endpunkt nicht.
API-Schnellstart
# 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"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
