Wählen Sie Z-Image Spicy für textgenerierte Bilder mit bis zu 1536 Pixeln je Kante, ab $0.01235 je Bild. Wählen Sie Spicy Pro, wenn eine Kante 1536 überschreiten muss, bis zu 2560 Pixel, für $0.019. Beide sind unzensierte Text-zu-Bild-Aufgaben. Keine nimmt eine Bildreferenz entgegen, verwenden Sie also einen separaten Editor, wenn ein freigegebenes Gesicht gleich bleiben muss.
Beide übernehmen unzensierte Briefings genau so, wie sie geschrieben sind, mit deaktivierter Prompt-Erweiterung; in unseren Tests vom September 2026 hat Spicy einmal einen Teil der Szene bei der stärksten Anforderung verloren, Pro nicht (Details: Ist Z-Image unzensiert?). Unten: eine vollständig bekleidete fiktive erwachsene Tänzerin mit einem Korallfächer, zuerst ein Porträt, dann ein breites Ankündigungsbild.
Leinwand und Preis gemeinsam wählen
| Einstellung | Z-Image Spicy | Z-Image Spicy Pro |
|---|---|---|
| Breite und Höhe | Je 256–1536 | Je 256–2560 |
| Standardwerte | 1024 × 1536 | 1024 × 1024 |
| Erweiterung aus | $0.01235/Bild | $0.019/Bild |
| Erweiterung an | $0.0133/Bild | $0.019/Bild |
| Prompt-Länge | Kein Limit | Kein Limit |
| Seed | 0–2147483647 | Gleich |
| Negativ-Prompt, Quellbild, Maske, LoRA | Nicht verfügbar | Nicht verfügbar |
Senden Sie width und height; ein Feld aspect_ratio gibt es nicht. Nützliche Leinwände: 960 × 1200 für eine 4:5-Karte, 864 × 1536 für ein 9:16-Story-Format, 1536 × 864 für 16:9, alle im normalen Spicy. Nehmen Sie Pro für 2560 × 1440 oder jedes 1600 Pixel breite Format: Spicy lehnt eine Breite von 1600 ab, und eine Verringerung allein der Breite auf 1536 ändert das Seitenverhältnis stillschweigend.
Die Abrechnung erfolgt je Bild, nicht je Pixel, ein 2560 × 2560 Pro-Format kostet also dieselben $0.019 wie ein 1024-Quadrat, und ein kleiner Entwurf spart nichts. Eine andere Leinwand ändert das Bild auch bei gleichem Seed, entwerfen Sie also in der Größe, in der Sie abliefern. Halten Sie die lange Seite höchstens etwa doppelt so lang wie die kurze, sofern die Leere nicht gerade der Sinn des Bildes ist.
Zuerst das Porträt im Playground testen
- Öffnen Sie die Z-Image Spicy Seite und bleiben Sie im Tab Playground in der Ansicht Form. Melden Sie sich mit einem aufgeladenen Konto an, um zu starten.
- Setzen Sie Width auf 960 und Height auf 1200, lassen Sie Prompt expansion aus und geben Sie einen Seed wie 314159 ein.
- Fügen Sie den untenstehenden Prompt in Prompt ein und starten Sie das Modell; prüfen Sie Fächer, Hände und Schuhe, bevor Sie das Ergebnis verwenden.
Die verwandte Z-Image-Seite für Text-zu-Bild, nicht die Spicy-Seite: die Ansicht Form mit dem Feld Prompt und der Schaltfläche Run.
Natürliches redaktionelles Modebild einer fiktiven erwachsenen Tänzerin mit 32 Jahren, die allein in einem ruhigen Studio probt. Sie trägt eine kobaltblaue Langarmbluse, einen elfenbeinfarbenen Rock und einfache Probeschuhe. Vollständiger Körper in einer sanften Vierteldrehung, beide Schuhe ruhen auf dem Holzboden. Eine Hand hält den Griff eines geöffneten Korallfaltfächers neben ihrer Schulter, der Griff ist sichtbar und der Fächer ist vom Gesicht abgewandt. Ihre andere Hand hängt entspannt. Schlichte ockerfarbene Wand, weiches Seitenlicht, großzügiger Raum über dem Fächer und unter den Schuhen. Keine Schrift, keine Spiegel, keine zusätzlichen Personen und keine weiteren Fächer.
Ohne Feld für einen Negativ-Prompt gehören Ausschlüsse in den Prompt, deshalb ist der letzte Satz die Leitplanke. Die Wörter, die Fächer, Hand und Rahmen definieren, leisten mehr als eine Reihe von "Masterpiece"-Adjektiven. Halten Sie die erste Pose ruhig genug, um zu erkennen, welche Hand den Gegenstand hält; erkunden Sie erst eine volle Tanzbewegung, wenn das Outfit-Konzept steht.
Illustration, kein Ergebnis des Zielmodells: der sichtbare Griff am Drehpunkt des Fächers ist die Beziehung, die dieser Prompt verlangt.
Um Kandidaten zu vergleichen, ändern Sie einen Satzteil und starten Sie jedes Mal mit einem neuen Seed erneut. Der Request-Body im Playground ist dasselbe JSON, das die API annimmt, eine hier funktionierende Einrichtung lässt sich also direkt in Code übernehmen. Für Pro öffnen Sie die Z-Image Spicy Pro Seite und verwenden dieselben Felder mit größeren Limits.
Anschließend aus dem Code aufrufen
Installieren Sie das Python SDK (pip install spicyapi), setzen Sie SPICY_API_KEY in Ihrer Serverumgebung und führen Sie aus:
import uuid
from spicyapi import SpicyClient, output_assets
client = SpicyClient() # reads SPICY_API_KEY from the environment
task = client.create_task(
model="alibaba/z-image-spicy/text-to-image",
input_data={
"prompt": "Natural editorial fashion image of one fictional adult dancer aged 32, rehearsing alone in a quiet studio. She wears a cobalt long-sleeved blouse, an ivory skirt and simple rehearsal shoes. Complete body in a gentle quarter turn, both shoes resting on the wooden floor. One hand holds the handle of one open coral folding fan beside her shoulder, with the grip visible and the fan away from her face. Her other hand hangs relaxed. Plain ochre wall, soft side light, generous room above the fan and below the shoes. No lettering, mirrors, extra people or additional fans.",
"width": 960,
"height": 1200,
"enable_prompt_expansion": False,
"seed": 314159,
},
idempotency_key=str(uuid.uuid4()),
)
print("Task", task["taskId"], flush=True)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
raise RuntimeError(f"{task['taskId']} ended as {final['state']}: {final.get('errorCode')}")
assets = output_assets(final)
if not assets or any(
not asset.get("url") or asset.get("pending") or asset.get("unavailable")
for asset in assets
):
raise RuntimeError(f"{task['taskId']} has no complete downloadable output; look up this task before retrying")
print(assets[0]["url"]) # copy the image to your own storage nowErstellen, Warten, Herunterladen, Wiederholungen und Fehlercodes stehen im Aufgaben-Leitfaden und in der Python SDK Referenz. Ergebnisse laufen ab, sehen Sie also Aufbewahrung und Auslieferung, bevor Sie auf dem zurückgegebenen Link aufbauen.
Oder ein Agent übernimmt das Ausführen
Wenn ein Assistent die Generierungen ausführen soll, zeigen alle drei offiziellen Tools den Preis und fragen vor einem kostenpflichtigen Aufruf nach.
- CLI. Speichern Sie dasselbe
input-Objekt ininput.jsonund führen Sie dann Folgendes aus:
``bash spicyapi tasks create --model alibaba/z-image-spicy/text-to-image --input-file input.json --wait ``
Siehe die CLI-Doku; npx @spicyapi/cli funktioniert ohne Installation.
- MCP-Server. Fügen Sie Ihrem Assistenten den MCP-Server hinzu und fragen Sie dann: "Run Z-Image Spicy at 960 by 1200 with this prompt, prompt expansion off." Er ruft
spicyapi_task_createauf, das für Ihre Preisbestätigung stoppt, und danachspicyapi_task_wait. - Skill.
npx skills add spicyapi-ai/spicy-skillinstalliert den Agent Skill, der einen Coding-Assistenten das aktuelle Modell-Schema lesen lässt, statt Felder zu raten.
Das breite Bild als bewusstes neues Layout
Wechseln Sie auf width: 1536, height: 864. Ersetzen Sie im Porträt-Prompt "Vollständiger Körper in einer sanften Vierteldrehung, beide Schuhe ruhen auf dem Holzboden." durch die ersten beiden Sätze unten und "großzügiger Raum über dem Fächer und unter den Schuhen" durch den dritten:
Platzieren Sie die vollständige Tänzerin auf der linken Bildseite in einer sanften Vierteldrehung, beide Schuhe ruhen auf dem Holzboden. Halten Sie den ganzen geöffneten Fächer vom Bildrand fern. Reservieren Sie das rechte Drittel als ruhige ockerfarbene Wand für separat hinzugefügten Veranstaltungstext.
Das ist ein neues textgeneriertes Bild, keine Bearbeitung des Porträts, und derselbe Seed überträgt das freigegebene Gesicht nicht von einer Leinwand auf die andere. Wenn die Identität übereinstimmen muss, behalten Sie das ausgewählte Porträt und verwenden Sie für das Banner einen Bildeditor mit Referenzunterstützung oder einen gewöhnlichen Freistell- und Layoutprozess.
Fügen Sie den echten Titel, das Datum und den Ort anschließend in Ihrem Design-Tool hinzu; eine leere Wand ist eine Layout-Anfrage, keine Zusage für korrekt geschriebenen generierten Text. Ist die Wand zu schmal, setzen Sie den Text außerhalb des Bildes, statt den Fächer zu überdecken.
Diese Fehler vor dem Wechsel zu Pro beheben
| Fehler | Konkrete Korrektur |
|---|---|
| Fächer verschmilzt mit der Hand | Fordern Sie "eine Hand um den schmalen Griff unterhalb des Fächerdrehpunkts geschlossen" und halten Sie den Fächer weg vom Blusenrand. |
| Schuhe sind beschnitten | Verwenden Sie eine Porträtformat im Format 4:5 oder 2:3; schreiben Sie "vollständiger Körper mit sichtbarem Boden unter beiden Schuhen". Entfernen Sie Formulierungen wie Nahaufnahme. |
| Zwei Tänzerinnen erscheinen | Entfernen Sie Wörter wie Gruppe, Menge, Spiegel oder Partnerin; behalten Sie "eine Erwachsene, allein probend". |
| Titelbereich ist unruhig | Entfernen Sie dekorative Fenster, Wandmuster und dramatische Lichtstrahlen; fordern Sie eine schlichte Wand im rechten Drittel. |
| Fächer verdeckt das Gesicht | Platzieren Sie ihn neben der Schulter und außerhalb der Gesichtssilhouette. |
Pro behebt weder Anatomie noch Layout; überarbeiten Sie zuerst das Briefing und wechseln Sie erst, wenn eine Kante 1536 überschreiten muss.
Erweiterung und Seeds
Lassen Sie die Prompt-Erweiterung aus. Sie schreibt den Prompt vor der Generierung um und kann Formulierungen vereinfachen, die Sie bewusst gewählt haben; das zählt am meisten für Briefings mit Erwachsenenbezug. Schalten Sie sie nur für eine Einzeiler-Idee ein, bei der Sie eine andere Szene akzeptieren; sie kostet $0.00095 je Bild im normalen Spicy und nichts auf Pro.
Die Modellseite sagt, dass ein ausgelassener Seed (oder 0) zufällig zieht, aber eine wiederholte Anfrage ohne Seed lieferte in unseren Tests auf beiden Stufen dasselbe Bild. Senden Sie also für jeden Kandidaten einen anderen seed. Ein Seed hält einen Durchlauf vergleichbar, garantiert aber kein identisches Bild; speichern Sie daher die ausgewählten Dateien, statt sich auf eine Zahl zu verlassen.
Illustration, kein Ergebnis des Zielmodells: physische Abzüge stehen für die Überprüfung von Porträtkonzepten.
Budget und Entscheidung
Vier normale Spicy-Kandidaten mit ausgeschalteter Erweiterung kosten $0.0494; vier Pro-Kandidaten kosten $0.076. Starten Sie für alles innerhalb von 1536 Pixeln auf Spicy; zahlen Sie für Pro, wenn die Platzierung eine längere Seite braucht, und beheben Sie das Briefing, nicht die Version, wenn Anatomie oder Layout falsch sind.
