Z-Image API: 0,008 $ pro Bild, echte Ausgaben und Code

Zusammenfassung in einem Satz

• Z-Image ist ein schnelles Text-zu-Bild-Modell von Alibabas Tongyi. Auf HiAPI lautet die Modell-ID z-image, die Kosten betragen 0,008 $ pro Bild: 1.000 Bilder kosten insgesamt 8 $.
• Die Anfrage enthält nur zwei Felder: prompt (maximal 1.000 Zeichen) und aspect_ratio (1:1, 4:3, 3:4, 16:9, 9:16). Keine Größe, Auflösung, Seed oder Bildeingabe.
• Es eignet sich hervorragend für fotorealistische Produktbilder mit kurzem englischem Text. In den folgenden vier Tests wurde jeder Text korrekt ausgegeben.Öffnen Sie die Z-Image-Modellseite, um es auszuprobieren; neue Konten erhalten 200 kostenlose Credits.

Preisgestaltung

Anzahl Bilder	Kosten für z-image
1	0,008 $
100	0,80 $
600 (200 Produkte × 3 Bilder)	4,80 $
1.000	8,00 $

Live-Preise von HiAPI, abgefragt am 20. Oktober 2026. Einheitlicher Preis für alle Seitenverhältnisse. Fehlgeschlagene Aufgaben werden nicht berechnet.

Zum Vergleich mit anderen kostengünstigen Modellen auf HiAPI:

Modell	Pro Bild	Text auf dem Bild
flux-schnell/text-to-image	0,005 $	Nicht seine Stärke
z-image	0,008 $	Kurzer englischer Text, in unseren Tests zuverlässig
qwen-image-2.1-turbo	0,02 $	Unterstützt Chinesisch und Englisch; akzeptiert außerdem Referenzbilder
gpt-image-2/text-to-image	0,03 $ bei 1K-Auflösung	Starke Leistung; kann auch Bilder bearbeiten

Weitere Optionen (auch Video) finden Sie unter Die günstigsten Bild- und Video-APIs auf HiAPI.

Echte Ausgaben: Produktbilder mit Text

Preisschild (1:1)

Studio-E-Commerce-Produktfoto: eine matte schwarze isolierte Edelstahl-Trinkflasche mittig auf einem nahtlosen hellgrauen Hintergrund mit weichem Schatten. Eine rechteckige korallenfarbene Papierkarte lehnt an der Flasche. Die Karte enthält NUR diese zwei Zeilen fetten, sauberen Sans-Serif-Text und keine anderen Wörter: In der ersten Zeile "SUMMER SALE", in der zweiten Zeile "$19.99". Der Text liegt flach zur Kamera, ist groß und vollkommen lesbar. Fotorealistisch.

Mit diesem Prompt generieren →

z-image, 1:1, 1536×1536, 0,008 $.

Beide Textzeilen sind korrekt. Die Karte hängt am Ende am Griff der Flasche, statt an der Flasche zu lehnen. Die erste Version dieses Prompts lautete "reads exactly: SUMMER SALE on the first line and $19.99 on the second line", woraufhin das Modell zwischen den beiden Zeilen ein zusätzliches Wort "ON" druckte. Setzen Sie den exakten Text in Anführungszeichen und schreiben Sie die Anweisungen außerhalb der Anführungszeichen.

Breites Banner (16:9)

Breites E-Commerce-Werbebanner, fotorealistische Flatlay-Aufnahme: weiße Sneaker und ein Versandkarton aus Kraftpapier auf einem sanft blauen Hintergrund. Rechtsseitig fetter marineblauer Sans-Serif-Text mit genau diesen vier Wörtern und dem Betrag, nichts weiter: "FREE SHIPPING OVER $50". Alle vier Wörter müssen erscheinen. Der Text ist groß, gerade und vollkommen lesbar. Saubere kommerzielle Studiobeleuchtung.

Mit diesem Prompt generieren →

z-image, 16:9, 1344×768, 0,008 $.

Social-Media-Karte (3:4)

Vertikale Social-Media-Produktkarte: eine kleine braune Glas-Pipettenflasche für Kosmetik auf einem warmen beigen Podest, weiches Tageslicht. Über der Flasche steht eine fette schwarze moderne Sans-Serif-Überschrift mit genau dem Inhalt: 30% OFF TODAY ONLY. Der Text liegt flach zur Kamera, ist groß und vollkommen lesbar. Minimalistischer Premium-E-Commerce-Stil, fotorealistisch.

Mit diesem Prompt generieren →

z-image, 3:4, 928×1232, 0,008 $.

Der Text ist korrekt, aber die Pipette überlappt das Wort "ONLY". Wenn die Überschrift klar bleiben muss, geben Sie die Position des Produkts an ("in the lower half, below the text", also in der unteren Hälfte, unter dem Text).

Kleiner Etikettentext (3:4)

Makro-E-Commerce-Produktfoto: eine Hautpflegeflasche aus satiniertem Glas mit einem sauberen weißen Etikett. Der Etikettentext ist in eleganter dunkler Sans-Serif-Schrift gedruckt und lautet genau: In der ersten Zeile GLOW SERUM, in der zweiten Zeile VITAMIN C 10%. Frontale Ansicht, Etikett vollständig sichtbar und scharf, weiche Studiobeleuchtung, fotorealistisch, weißer Hintergrund.

Mit diesem Prompt generieren →

z-image, 3:4, 928×1232, 0,008 $.

Kleiner Text auf gekrümmten Flächen ist die schwierigste der vier Aufgaben, aber die Ausgabe war sauber. Das Modell hat "VITAMIN C 10%" auf zwei Zeilen verteilt.

Regeln für korrekt ausgegebenen Text

1. Setzen Sie den exakten Text in Anführungszeichen.
2. Fügen Sie "and no other words" (keine anderen Wörter) hinzu, damit das Modell keine zusätzlichen Badge-Texte erfindet.
3. Lassen Sie den Text flach zur Kamera liegen. Schräger oder gebogener Text geht zuerst schief.
4. Platzieren Sie pro Bild nur einen oder zwei Textblöcke. Längere Texte layouten Sie anschließend im Design-Tool.
5. Prüfen Sie jedes Bild vor der Veröffentlichung. Bei 0,008 $ pro Bild sind die Kosten für eine erneute Generierung praktisch vernachlässigbar.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image",
    "input": {
      "prompt": "A cozy coffee shop at golden hour, a wooden A-frame sign on the sidewalk reading \"FRESH COFFEE\", warm window light, photorealistic",
      "aspect_ratio": "16:9"
    }
  }'

Sie erhalten eine taskId. Fragen Sie GET https://api.hiapi.ai/v1/tasks/{taskId} ab, bis data.status den Wert success hat, und laden Sie dann data.output[0].url herunter. Der Status durchläuft nacheinander queued, handling und archiving und wird schließlich zu success oder fail. Die Links laufen etwa 7 Tage nach Abschluss der Aufgabe ab.

Python: Verarbeitung kleiner Mengen

# pip install requests；zuerst export HIAPI_KEY=your-key
import os, time, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def submit(prompt, ratio="1:1"):
    r = requests.post(API, json={"model": "z-image", "input": {"prompt": prompt, "aspect_ratio": ratio}},
                      headers=H, timeout=30).json()
    if r.get("code") != 200:
        raise RuntimeError(r)
    return r["data"]["taskId"]

def wait(task_id, timeout_s=300):
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] in ("success", "fail"):
            return d
        time.sleep(3)
    raise TimeoutError(task_id)

products = {"mug-sage": "sage green", "mug-navy": "navy blue", "mug-terracotta": "terracotta"}
tasks = {sku: submit(f'Studio photo of a {color} ceramic coffee mug on white, a small card reads "NEW"')
         for sku, color in products.items()}   # erst alle einreichen, dann gesammelt abholen

for sku, task_id in tasks.items():
    d = wait(task_id)
    if d["status"] == "success":
        with open(f"{sku}.png", "wb") as f:
            f.write(requests.get(d["output"][0]["url"], timeout=120).content)
    else:
        print(sku, "failed:", d.get("error"))

Parameter und Fehler

Feld	Pflichtfeld	Werte
prompt	Ja	Maximal 1.000 Zeichen
aspect_ratio	Nein	1:1, 4:3, 3:4, 16:9, 9:16

In den folgenden Fällen wird beim Einreichen HTTP 400 zurückgegeben; es wird keine Aufgabe erstellt und nichts berechnet:

• additional properties 'size' not allowed (oder resolution, width): Verwenden Sie stattdessen aspect_ratio.
• aspect_ratio: value must be one of ...: 21:9 oder 4:5 werden nicht unterstützt. Generieren Sie zuerst mit 16:9 oder 3:4 und schneiden Sie dann zu.
• Verwendung einer Modell-ID wie z-image-turbo: Die einzige ID auf HiAPI ist z-image.

Wann Sie besser ein anderes Modell verwenden sollten

• Sie müssen ein vorhandenes Bild bearbeiten: Z-Image kann nur aus Text generieren. Verwenden Sie ein Bild-zu-Bild-Modell wie qwen-image-2.1-turbo (0,02 $) oder gpt-image-2/image-to-image.
• Der Text ist lang oder dicht, oder viel Chinesisch: Probieren Sie Qwen Image, das speziell für zweisprachige Typografie entwickelt wurde.
• Sie wollen den niedrigsten Preis und brauchen keinen Text: flux-schnell/text-to-image kostet 0,005 $.

Häufige Fragen

Wie lautet die Modell-ID?

z-image. Auf HiAPI gibt es keine separate ID z-image-turbo; Turbo ist der Name dieser schnellen Variante beim Upstream-Anbieter.

Wie erhalte ich einen API-Schlüssel?

Registrieren Sie sich auf hiapi.ai, erstellen Sie einen Schlüssel in der Konsole und senden Sie ihn als Authorization: Bearer <key>. Derselbe Schlüssel gilt für alle Modelle.

Kann es chinesischen Text darstellen?

Alibaba führt zweisprachigen Text als Stärke auf. Die oben genannten vier Tests waren alle auf Englisch. Prüfen Sie daher die chinesische Ausgabe mit Ihren eigenen Prompts, bevor Sie sich darauf verlassen.

Gibt es eine Auflösungseinstellung?

Nein. Die Ausgabegröße richtet sich nach dem Seitenverhältnis: In den obigen Tests ergab 1:1 1536×1536, 16:9 1344×768 und 3:4 928×1232.

Wollen Sie Prompts ausprobieren, ohne Code zu schreiben?Öffnen Sie die Z-Image-Modellseite.