Einführung
Z-Image Text-zu-Bild macht aus einer schriftlichen Beschreibung ein einzelnes Bild, typischerweise in rund einer Sekunde. Genau darum geht es: Die Generierung wird so günstig, dass man sie als Schleife behandeln kann statt als Festlegung.
Z-Image ist die kompakte 6B-Bildfamilie von Tongyi, abgestimmt auf fotorealistische Ergebnisse in etwa einer Sekunde und hier als einzelner Text-zu-Bild-Endpunkt veröffentlicht. Fünf Seitenverhältnisse, verlustfreies PNG, Prompts bis 1.000 Zeichen. Unzensiert.
Wichtige Funktionen und Highlights
Zwanzig Iterationen statt eines vorsichtigen Prompts
Bei rund einer Sekunde pro Bild schreiben Sie Prompts nicht mehr defensiv. Eine Zeile schreiben, ansehen, anpassen, wieder ansehen – die Schleife ist so kurz, dass sich Gespür aus Belegen bildet statt aus Vermutungen, und zwanzig Versuche kosten hier immer noch weniger als ein Aufruf eines schweren Finishing-Modells.
Schnappschuss-Textur statt Studioglanz
Seine stärkste Tonlage ist die unglamouröse: Spiegelselfies mit dem Handy, Neonröhren von oben, leichte Bewegungsunschärfe, feuchte Haare. Verlangen Sie einen Schnappschuss, und Sie bekommen etwas, das aufgenommen wirkt statt gerendert – genau das, was schwerere Modelle gern wegpolieren.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Bis 1.000 Zeichen – ein bewusst kleines Budget. mindestens 1 Zeichen · höchstens 1000 Zeichen |
aspect_ratio | Nein | Die Form der Ausgabe: fünf Werte, standardmäßig quadratisch, von 16:9 quer bis 9:16 hoch. |
enable_prompt_expansion | Nein | Standardmäßig aus – der Prompt wird so verwendet, wie er dasteht. Standardwert: |
output_format | Nein |
|
seed | Nein | Ganzzahl von 0 bis 2147483647 für den Zufallsstart; ohne Angabe zieht jeder Lauf seinen eigenen. |
Preis
$0.01 / Bild
Anwendungsfälle
Mit einem schriftlichen Brief beginnen
Nutzen Sie diesen Endpunkt, wenn Sie eine schriftliche Idee in vielen schnellen Varianten sehen wollen: Jeder Aufruf liefert in etwa einer Sekunde ein verlustfreies PNG in einem von fünf Seitenverhältnissen. Bewahren Sie jeden Prompt, der trifft, zusammen mit seinem seed auf.
Figurenserien in großer Menge
Porträts und Rollenspiel-Szenerien, zwanzig Richtungen auf einmal erkundet, ohne Flag und ohne separaten Endpunkt. Jeder Lauf zieht sein eigenes Bild; behalten Sie die Prompts, die treffen, und variieren Sie Garderobe und Umgebung jeweils um einen Satzteil.
Konzeptarbeit vor einem Finishing-Modell
Finden Sie die Komposition hier, wo ein Bild rund eine Sekunde kostet, und nehmen Sie die funktionierende Formulierung dann zu einem langsameren Modell mit höherer Obergrenze für die Version, die ausgeliefert wird. Dasselbe fotografische Vokabular, kein Umbau.
Inhalte, die wie ein echter Schnappschuss aussehen
Spiegel-Selfies, Neonröhren im Fitnessstudio und harte Deckenlampen, beiläufige Handykamera-Bildausschnitte – die Anmutung, die im Feed wie ein echtes Foto wirkt. Fordern Sie die Makel ausdrücklich an: Neonstich, Bewegungsunschärfe, ungleichmäßige Schärfe.
Prompt-Leitfaden und Praxistipps
Den Brief knapp und konkret halten
1.000 Zeichen sind ein kleines Budget – geben Sie es für Licht, Objektiv und Textur aus. Das veröffentlichte Standbild entstand aus: „iPhone mirror selfie, an adult woman in a charcoal sports bra and low-slung grey joggers standing in an empty late-night gym, midriff bare, one hand holding the phone, hair damp, casual confident smirk, overhead fluorescent light, slight motion blur, authentic amateur snapshot look.“
Den Prompt beim gelungenen Bild aufbewahren
Ohne seed ziehen identische Anfragen unterschiedliche Bilder. Speichern Sie Prompt und seed neben der Datei und ändern Sie jeweils einen Satzteil, während Sie nach etwas Besserem suchen; bei festem seed kommt der sichtbare Unterschied von diesem Satzteil.
Das mitgelieferte Beispiel anpassen
Beginnen Sie mit dem veröffentlichten Beispiel mit aspect_ratio: 1:1 und output_format: png. Ersetzen Sie Motiv und kreative Richtung, behalten Sie aber den Eingabevertrag dieses Modus bei.
iPhone mirror selfie, an adult woman in a charcoal sports bra and low-slung grey joggers standing in an empty late-night gym, midriff bare, one hand holding the phone, hair damp, casual confident smirk, overhead fluorescent light, slight motion blur, authentic amateur snapshot look.
Eine quadratische Fassung der Anfrage hinter dem veröffentlichten Standbild: ein Schnappschuss-Brief, der Lichtquelle, Unschärfe und Bildausschnitt benennt, statt Qualität zu verlangen.
Das Ergebnis prüfen, bevor Sie iterieren
Die Prompt-Grenze liegt bei 1.000 Zeichen, und ein längerer Prompt wird vor dem Absenden abgelehnt statt gekürzt – dieses Modell belohnt einen knappen Brief, keine Shotliste. Jedes Seitenverhältnis entspricht einer festen Größe im nativen Bereich von etwa einem Megapixel; es gibt also keinen Auflösungsschalter und keinen Weg zu einem großen Auslieferungsbild. Feine Typografie und dichte kleine Details sind nicht das, wofür ein 6B-Modell gemacht ist.
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-turbo/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"output_format": "png",
"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.
