Grok Imagine Bild-API: Text-zu-Bild, Bild-zu-Bild und Quality

Die wichtigsten Punkte

• Die Grok Imagine Bild-API auf HiAPI hat insgesamt vier Endpunkte: Standard und Quality, wobei jede Version sowohl Text-zu-Bild als auch Bild-zu-Bild bietet. Die Anforderungsstruktur aller vier ist identisch, nur die Modell-ID unterscheidet sich.
• Standard kostet $0.03 pro Bild bei 1K oder 2K Auflösung. Quality kostet $0.07 bei 1K und $0.10 bei 2K. Bei Bild-zu-Bild wird pro Referenzbild (1–3 Referenzen) eine kleine zusätzliche Gebühr erhoben.
• Bei identischem Prompt zeichnete Standard einen gewöhnlichen Kegel ohne Griff und ohne Strömungsrippen; Quality zeichnete einen erkennbaren Handfilter. Standard eignet sich für Entwürfe und große Stapelverarbeitung, Quality für das finale Ergebnis. Öffne die Modellseite für Text-zu-Bild und probiere es aus; neue Konten erhalten 200 kostenlose Credits.

Welcher Endpunkt verwendet werden sollte

Modell-ID	Eingabe	Preis pro Bild	Anwendungsfall
grok-imagine/text-to-image	Prompt	$0.03 (1K und 2K)	Entwürfe, Massengenerierung, ultrawide Banner
grok-imagine-quality/text-to-image	Prompt	$0.07 (1K) / $0.10 (2K)	Finale Produktbilder, Details und Materialien
grok-imagine/image-to-image	Prompt + 1–3 Bilder	$0.03 + $0.003 pro Referenzbild	Produkte in Szene setzen, Bildbearbeitung im Stapel
grok-imagine-quality/image-to-image	Prompt + 1–3 Bilder	$0.08 (1K) / $0.10 (2K) + $0.015 pro Referenzbild	Neu beleuchten und Stil ändern bei vollständig konsistentem Motiv

HiAPI-Live-Preise, abgefragt am 19. Oktober 2026. Fehlgeschlagene Aufgaben werden nicht berechnet.

Die Bearbeitung mit einem einzelnen Referenzbild kostet bei Standard $0.033 und bei Quality 1K $0.095. Für die komplette Reihe einschließlich Video und Grok Imagine Image 2.0 siehe Grok Imagine API-Preise.

Derselbe Prompt, Standard vs. Quality

1:1, 2K, PNG, jeweils einmal ausgeführt:

matte ceramic pour-over coffee dripper on a pure white seamless background, studio softbox lighting, centered, no shadow gradient beyond a soft contact shadow, no text, no watermark, no props, e-commerce product photography, sharp focus

Standard:

grok-imagine/text-to-image, 1:1, 2K, 2048×2048, $0.03, ca. 80 Sekunden.

Quality:

Diesen Prompt mit Quality generieren →

grok-imagine-quality/text-to-image, 1:1, 2K, 2048×2048, $0.10, ca. 78 Sekunden.

Die Unterschiede:

• Das Objekt selbst: Standard rendert einen sauberen, aber generischen Kegel, eher eine Schale als ein Filter. Quality zeichnet die Bauteile, die es zu einem Handfilter machen: innere spiralförmige Strömungsrippen, einen Griff und einen Sockel mit Abflusslöchern.
• Beide befolgten die Hintergrundvorgaben: reinweiß, zentriert, nur ein weicher Kontaktschatten, keine Requisiten oder Text.
• Gleiche Größe und Geschwindigkeit: Beide liefern innerhalb von etwa 80 Sekunden ein 2048×2048-Bild. Die Stufe ändert die Details, nicht die Ausgabegröße.

Bei bekannten Produkten sind die zusätzlichen $0.07 für Quality es wert. Bei Moodboards oder Layoutentwürfen, bei denen das Objekt selbst generisch ist, reicht Standard aus.

Bild-zu-Bild: das eigene Produkt in eine Szene setzen

Übergebe 1–3 öffentliche Bild-URLs in image_urls und beschreibe die gewünschten Änderungen. Wenn aspect_ratio auf auto steht (der Standard bei Bild-zu-Bild), übernimmt die Ausgabe die Form des ersten Bildes in der Liste. Derselbe Prompt, dieselben zwei Bilder, nur die Reihenfolge vertauscht, ergibt zwei verschiedene Zuschnitte:

grok-imagine/image-to-image, Produktbild zuerst, gibt 1248×832 zurück (3:2).

Dieselbe Anfrage, Szenenbild zuerst, gibt 1024×1024 zurück (1:1).

Um den Zuschnitt zu steuern, platziere das Bild mit der gewünschten Form an erster Stelle oder setze aspect_ratio explizit.

Bei Quality liegt die Stärke darin, eine Sache zu ändern, während alles andere gleich bleibt. Diese Neubeleuchtung behielt Gesicht, Jacke, Tasse und Komposition bei:

Relight this photo as late golden hour: warm low sun coming from the left,
long soft shadows across the table, amber rim light on her hair and jacket.
Keep her face, expression, pose, the corduroy jacket, the marble table, the
coffee cup and the entire composition exactly the same. Photorealistic, same
camera angle, same framing.

grok-imagine-quality/image-to-image, 1K, auto (Eingabe 3:2, Ausgabe 1248×832), ein Referenzbild, $0.095, 39 Sekunden.

Ein bewährtes Muster: In einem Satz sagen, was geändert werden soll, dann alles auflisten, was unverändert bleiben muss. Weitere Rezepte finden sich unter Grok Imagine Quality Bild-zu-Bild-Prompts.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine/text-to-image",
    "input": {
      "prompt": "A lighthouse on a rocky cliff at golden hour, waves crashing below, photorealistic",
      "aspect_ratio": "2:1",
      "resolution": "2k",
      "output_format": "png"
    }
  }'

Du erhältst eine taskId. Frage GET https://api.hiapi.ai/v1/tasks/{taskId} ab, bis data.status gleich success ist, und lade dann data.output[0].url herunter. Der Link läuft ab, speichere die Datei sofort.

Python: alle vier Endpunkte

# pip install requests; export HIAPI_KEY=your-key first
import os, time, uuid, requests

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

def generate(model, prompt, image_urls=None, timeout_s=300, **params):
    body = {"model": model, "input": {"prompt": prompt, **params}}
    if image_urls:
        body["input"]["image_urls"] = image_urls
    # Reuse the same Idempotency-Key if you retry a submit, so a retry never bills twice
    r = requests.post(API, json=body, headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)  # 400s list every invalid field
    task_id = res["data"]["taskId"]
    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"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(5)
    raise TimeoutError(task_id)

# Draft on standard, then re-run the keeper on Quality
draft = generate("grok-imagine/text-to-image", "matte ceramic pour-over dripper, white background",
                 aspect_ratio="1:1", resolution="1k")
final = generate("grok-imagine-quality/text-to-image", "matte ceramic pour-over dripper, white background",
                 aspect_ratio="1:1", resolution="2k")

# Composite a product into a scene; the first image sets the shape
edit = generate("grok-imagine/image-to-image",
                "Place the product from the first image on the desk in the second image, matching its light",
                image_urls=["https://your-cdn.example.com/product.jpg",
                            "https://your-cdn.example.com/scene.jpg"])

Parameter

Feld	Pflichtfeld	Werte	Beschreibung
prompt	Ja	Text	Alles, was du willst oder vermeiden möchtest, gehört hierhin
image_urls	Nur bei Bild-zu-Bild	1–3 URLs	jpeg, png oder webp; SVG wird nicht unterstützt; jedes Referenzbild erhöht den Preis
aspect_ratio	Nein	2:1, 20:9, 19.5:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:19.5, 9:20, 1:2; Bild-zu-Bild akzeptiert zusätzlich auto	auto folgt dem ersten Bild
resolution	Nein	1k (Standard), 2k	Kleinbuchstaben; wirkt sich nur bei Quality auf den Preis aus
output_format	Nein	jpeg (Standard), png, webp

Die ultrawide Formate 2:1 und 20:9 eignen sich für Banner. Es gibt kein 21:9; verwende 20:9.

Fehler, auf die du stoßen wirst

Alle folgenden Fehler werden beim Absenden als HTTP 400 zurückgegeben, sodass keine Aufgabe erstellt und nichts berechnet wird:

• resolution: value must be one of '1k', '2k': Du hast 2K gesendet. Verwende Kleinbuchstaben.
• aspect_ratio: value must be one of ...: Meistens 21:9. Verwende 20:9.
• additional properties 'n' not allowed (oder seed, negative_prompt, size): Diese Felder existieren nicht. Eine Aufgabe erzeugt ein Bild; für mehrere Bilder sende mehrere Aufgaben.
• image_urls: missing required field: Bild-zu-Bild benötigt mindestens ein Bild.

Ein ungültiger Schlüssel liefert 401. Fehler nach der Aufgabenerstellung zeigen sich beim Abfragen als status: "fail", prüfe also data.status und nicht nur den HTTP-Statuscode.

Häufige Fragen

Standard oder Quality verwenden?

Entwirf mit Standard für $0.03. Sobald Prompt und Layout passen, führe das finale Ergebnis erneut mit Quality aus. Bei Standard kosten 2K und 1K gleich viel, fordere dort also immer 2k an.

Ist das dasselbe wie Grok Imagine Image 2.0?

Nein. grok-imagine-image-2.0 ist ein eigenständiges, neueres Modell für $0.052 pro Bild. Siehe Grok Imagine Image 2.0 Text-zu-Bild-Leitfaden.

Kann man mehrere Bilder aus einer Anfrage erhalten?

Nein. Es gibt kein n-Feld. Sende pro Bild eine Aufgabe; sie laufen parallel.

Wie lange sind Ausgaben verfügbar?

Die Links von output[0].url laufen ab. Lade die Datei nach erfolgreicher Aufgabe sofort herunter und speichere sie selbst.

Weitere echte Ausgaben: Standard-Produktkatalogbilder und Szenenkomposition für Produktfotos. Zu Video siehe Grok Imagine Video-API-Leitfaden.