popnow
AnmeldenLos geht’s

alibaba/z-image-turbo/text-to-imageAb 2 Credits pro Bild

Z-Image ist die kompakte 6B-Bildfamilie von Tongyi, abgestimmt auf fotorealistische Ausgabe in etwa einer Sekunde und als einzelner text-to-image-Endpunkt veröffentlicht. Fünf Seitenverhältnisse, verlustfreies PNG, 1.000 Zeichen Prompt.

Du rufst es mit dem Modellnamen alibaba/z-image-turbo/text-to-image über POST /jobs/createTask auf, ab 2 Credits pro Bild (0,02 $). Neue Konten bekommen 30 kostenlose Credits, damit du es zuerst im Playground testen kannst.

  • Bild erstellen
  • 5 Seitenverhältnisse
von AlibabaAPI-Schlüssel holenZ-Image: Beispiele und Prompts →

Diese Anleitung gibt es vorerst nur auf Englisch. →

Anfrageparameter

ParameterPflichtBeschreibung
seedNeinDieselbe Zahl liefert ein wiederholbares Ergebnis. ≥ 0 · ≤ 2147483647
promptJaDescribe the image to generate: subject, composition, style, and lighting.
aspect_ratioNeinDie Form des Bildes: breit, quadratisch oder hoch. 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · Standardwert: 1:1
output_formatNeinDateiformat des Ergebnisses. png · Standardwert: png
enable_prompt_expansionNeinLässt das Modell einen kurzen Prompt mit Details ergänzen. Standardwert: false

Preise

Die Preise sind in Credits angegeben, denselben Credits, die du auf der Website nutzt (1 Credit = 0,01 $). Beim Annehmen der Aufgabe wird der Betrag reserviert und nach Abschluss auf die tatsächlichen Kosten abgerechnet; fehlgeschlagene Aufgaben werden erstattet.

OptionCredits pro Bild≈ USD
Standard1,50,015 $
enable_prompt_expansion true2,40,024 $

Jede Aufgabe wird auf ganze Credits aufgerundet, ein Lauf in der günstigsten Stufe kostet also 2 Credits pro Bild (0,02 $).

Für eine exakte Zahl vor dem Start sendest du denselben Body an POST /jobs/quote.

API-Schnellstart

Die Z-Image API in drei Schritten aufrufen

  1. API-Schlüssel erstellen. Melde dich bei PopNow an und erstelle in der API-Konsole einen Schlüssel. Schlüssel beginnen mit sk-popnow- und nutzen dieselben Credits wie die Website.
  2. Anfrage senden. Sende POST /jobs/createTask mit model alibaba/z-image-turbo/text-to-image und einem input-Objekt nach der Parametertabelle. Die Antwort enthält sofort eine Task-ID.
  3. Ergebnis abholen. Frage GET /jobs/recordInfo mit der Task-ID ab oder gib eine callBackUrl mit, dann schicken wir das Ergebnis dorthin. Lade die Ausgabelinks herunter, sobald die Aufgabe erfolgreich ist.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $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"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Ersetze den Prompt und alle Links durch deine eigenen. Im Tab „API“ findest du die Referenz zu Antwort, Polling und Callback.

Fragen zur Z-Image API

Was kostet die Z-Image API?

Z-Image kostet 2 Credits (0,02 $) pro Bild. Preise nach Option: Standard 1,5 Credits pro Bild, true 2,4 Credits pro Bild. Die Credits sind dieselben wie auf der Website (1 Credit = 0,01 $), neue Konten bekommen 30 Gratis-Credits, und fehlgeschlagene Tasks werden erstattet.

Wie lautet der Modellname von Z-Image in der API?

Trag alibaba/z-image-turbo/text-to-image für Bild erstellen im Feld model von POST /jobs/createTask ein.

Wie schnell ist Z-Image wirklich?

Rund eine Sekunde für ein text-to-image-Bild. Genau darum geht es in dieser Familie: Die Schleife ist kurz genug, um Formulierungen als Experiment zu behandeln statt als Festlegung.

Was steuert aspect_ratio tatsächlich?

Die Pixelmaße der Ausgabe. Jedes Verhältnis bildet auf eine feste Größe rund um den nativen Ein-Megapixel-Bereich ab, sodass die Qualität über die Verhältnisse hinweg gleichmäßig bleibt, statt an den Extremen auseinanderzufallen.

Kann ich ein früheres Bild reproduzieren?

Weitgehend, wenn Sie den seed aufbewahrt haben: Mit gleichem Prompt, Seitenverhältnis und seed landet das Ergebnis sehr nah am früheren Bild, pixelgenau garantiert ist das aber nicht. Ohne seed liefern identische Anfragen verschiedene Bilder – speichern Sie Prompt und seed also zu jedem Asset, das Sie behalten wollen.

Warum liegt die Prompt-Grenze bei nur 1.000 Zeichen?

Mehr nimmt dieser Endpunkt nicht an: Ein längerer Prompt wird vor dem Absenden abgelehnt, nicht stillschweigend gekürzt. Es entspricht auch dem, was ein kompaktes 6B-Modell gut verwertet – eine knappe Beschreibung von Motiv, Licht und Textur schlägt hier eine lange Shotlist.

Welche Limits hat die Z-Image API?

Seitenverhältnisse: 1:1 · 4:3 · 3:4 · 16:9 · 9:16; Prompt-Länge (Zeichen): 1,000. Anfragen außerhalb dieser Grenzen werden abgelehnt, bevor etwas abgebucht wird.

Kann ich Z-Image testen, ohne Code zu schreiben?

Ja. Der Playground führt Z-Image mit deinen PopNow-Credits aus, braucht keinen API-Schlüssel und zeigt dir zu jedem Lauf den passenden Code.

Alle Z-Image-Modelle

Z-Image Turbo LoRA nutzt dieselbe Familie mit deinen eigenen LoRAs und bietet zusätzlich Bild zu Bild.

Mehr zu Z-Image