xAI

Grok Imagine Quality

grok-imagine-quality/text-to-image

Hochpräzises Bildgenerierungs- und -bearbeitungsmodell von xAI mit stabilerer Textdarstellung und Komposition, Unterstützung für 1K/2K-Ausgabe und konsistente Bearbeitung anhand von Referenzbildern

grok-imagine-quality/image-to-image grok-imagine-quality/text-to-image

grok-imagine-quality/text-to-image ausprobieren

Eingabe

Galerie

Alle Arbeiten ansehen

Ausgabe

image

Fülle die Parameter aus und generiere – die Ergebnisse erscheinen hier.

Preise

grok-imagine-quality/text-to-image per image

Spezifikationen	Einzelpreis
1K	$0.070
2K	$0.100

Positionierung im Überblick

grok-imagine-quality/text-to-image ist ein von xAI eingeführtes hochpräzises Text-zu-Bild-Modell und gehört innerhalb der Grok-Imagine-Bildserie zur Stufe, die auf fertige Qualität ausgerichtet ist. Es erzeugt aus Textaufforderungen fotorealistische Bilder, unterstützt die beiden Auflösungsstufen 1k und 2k, 13 Seitenverhältnisse sowie die drei Ausgabeformate jpeg, png und webp; eine einzelne Aufforderung umfasst bis zu 8000 Zeichen. Im Vergleich zur Standardversion ist es bei Detailschärfe, Natürlichkeit von Textur und Beleuchtung, der Textdarstellung im Bild sowie der Kompositionsstabilität stärker und eignet sich eher für Entwickler, die direkt fertige Ergebnisse liefern müssen, statt nur kreative Entwürfe zu erstellen.

Zentrale Highlights

Hochpräzise Stufe für Ergebnisse in Fertigqualität – Details, Texturen und Beleuchtung sind vollständiger als beim standardmäßigen Grok Imagine, die Ergebnisse ähneln eher direkt verwendbaren fertigen Bildern.
Unterstützung der beiden Auflösungsstufen 1k und 2k – über dieselbe Schnittstelle lässt sich von schnellen Entwürfen in niedriger Auflösung auf 2k-Feinarbeitung wechseln, ohne Modell oder Leitung zu wechseln.
13 Seitenverhältnisse decken gängige Layouts ab – von 1:1 bis 16:9, 9:16, 20:9 und weiteren Verhältnissen lassen sich alle direkt angeben, passend für Querformat-Poster, Hochformat-Social-Media und Breitbild-Banner.
Genauere Textdarstellung im Bild – Szenen mit Textlayout werden besser wiedergegeben, was Nacharbeit durch fehlerhaften Text in Poster- und Social-Media-Grafikszenarien reduziert.

Funktionsbeschreibung

Fotorealistische Bilder aus Textaufforderungen: Eine Beschreibung als Eingabe genügt, um ein Bild zu erzeugen; die Aufforderung umfasst bis zu 8000 Zeichen und kann vollständigere Beschreibungen von Szene, Stil und Motiv aufnehmen.

Auflösung und Seitenverhältnis steuerbar: Über resolution wird 1k oder 2k gewählt, über aspect_ratio wird aus 13 Verhältnissen das Bildformat festgelegt; die Ausgabe passt direkt zum Layout des Zielmaterials.

Ausgabeformat wählbar: Die drei Formate jpeg, png und webp werden unterstützt, sodass je nach Frontend-Darstellung, Materialarchivierung oder nachfolgender Komprimierung die passende Kodierung gewählt werden kann.

Wiedergabe benannter Entitäten: Die Genauigkeit bei der Darstellung benannter Entitäten wie Marken, Personen des öffentlichen Lebens und konkreter Orte ist hoch; die Zielobjekte können in der Aufforderung direkt benannt werden.

Anwendungsszenarien

Erstellung von Werbe- und Marketingmaterial – aus Produktverkaufsargumenten und Bildbeschreibungen werden 2k-Querformat- oder quadratische Key Visuals für Hero-Banner, Poster und Werbematerial erzeugt.
Social-Media-Bebilderung und Thumbnail-Design – im Verhältnis 16:9 oder 9:16 werden Titelbilder mit Textlayout erzeugt, die direkt für Video-Thumbnails und Social-Media-Bebilderung verwendet werden.
Iterativer Workflow vom Entwurf zur Feinarbeit – zunächst werden mit 1k-Auflösung kreative Richtungen in Stapeln erzeugt; nach der Auswahl wird mit 2k neu generiert für die endgültige Lieferversion.
Szenenbilder mit benannten Motiven – in der Aufforderung werden konkretes Fahrzeugmodell, Ort oder Marke angegeben, um szenische Bilder für Konzeptpräsentationen und Inhaltsbebilderung zu erzeugen.

Einschränkungen und Auswahlhinweise

Die Bildqualität wird mit einer geringeren Generierungsgeschwindigkeit erkauft; die Bilderzeugung ist langsamer als beim standardmäßigen Grok-Imagine-Bildmodell und eignet sich nicht für Szenarien, die zahlreiche schnelle Entwürfe erfordern. Bei hohen Auflösungen sowie Aufgaben mit strengen Anforderungen an benannte Motive und Bilddetails sind möglicherweise mehrere Anpassungen der Aufforderung nötig, um das gewünschte Ergebnis zu erzielen; es wird empfohlen, zunächst mit 1k die Richtung zu bestätigen und dann 2k zu erzeugen. Die aktuelle Leitung deckt nur Text-zu-Bild ab; wenn gezielte Bearbeitungen auf Basis vorhandener Bilder benötigt werden, sollte auf ein Bild-zu-Bild-Modell derselben Serie umgestiegen werden. Die konkreten Kosten werden pro Bild abgerechnet, maßgeblich ist das Preisfenster der Plattform.

Häufige Fragen

Alle Fragen ansehen →

Für welche finalen Bilder eignet sich Grok Imagine Quality?

Geeignet für Key Visuals, Cover, Werbekonzepte und hochwertige Szenenbilder, die stärkere Materialien, Licht- und Schattenwirkung, Atmosphäre und Details erfordern.
Wie werden 1k und 2k abgerechnet?

1k und 2k verwenden unterschiedliche Preisstufen pro Bild; Bildformat und Ausgabeformat werden nicht zusätzlich berechnet; die konkreten Beträge richten sich nach den aktuellen Preisen auf dieser Seite.
Warum nicht direkt den Standardmodus verwenden?

Bei Massenentwürfen und wenn Geschwindigkeit Priorität hat, ist der Standardmodus besser geeignet; erst wenn beim finalen Endprodukt Material und Details wichtiger sind, sollte Quality gewählt werden.
Werden Referenzbilder unterstützt?

Der aktuelle Text-to-Image-Pfad akzeptiert keine Referenzbilder; wenn Sie eine hochwertige Bearbeitung mit Referenzbild benötigen, verwenden Sie bitte grok-imagine-quality/image-to-image.

Generierungsaufgabe erstellen

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringPflicht

Account-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen

Content-TypestringOptional

Der Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.

Idempotency-KeystringOptional

Idempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.

Idempotenz-Schlüssel

Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.

Body

modelstringPflicht

Aktueller Festwert: grok-imagine-quality/text-to-image

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

Geschäftsparameter für grok-imagine-quality/text-to-image und Route default — siehe Parametertabelle unten.

promptstringPflichtminLength 1maxLength 8000

Textbeschreibung zur Bilderzeugung, als Zeichenkette, die den gewünschten Bildinhalt angibt.

resolutionstringOptionalStandard: "1k"

Auflösung des Ausgabebildes, als Zeichenkette, Standard 1k.

Optionen:1k2k

aspect_ratiostringOptionalStandard: "1:1"

Seitenverhältnis des erzeugten Bildes, als Zeichenkette, Standard 1:1.

Optionen:2:120:919.5:916:94:33:21:12:3

Alle anzeigen (5)

3:49:169:19.59:201:2

output_formatstringOptionalStandard: "jpeg"

Format des Ausgabebildes, als Zeichenkette, Standard jpeg.

Optionen:jpegpngwebp

callbackobjectOptional

Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.

Callbacks (Webhook)

Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.

urlstringPflicht

Pflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.

whenstringOptionalStandard: "final"

Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.

Optionen:final

storagestringOptionalStandard: "temp"

Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.

Optionen:temppersistent

Anfragebeispiele

# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine-quality/text-to-image",
  "input": {
    "prompt": "…",
    "resolution": "1k",
    "aspect_ratio": "1:1",
    "output_format": "jpeg"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "grok-imagine-quality/text-to-image",
    input: {
      "prompt": "…",
      "resolution": "1k",
      "aspect_ratio": "1:1",
      "output_format": "jpeg"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "grok-imagine-quality/text-to-image",
        "input": {
          "prompt": "…",
          "resolution": "1k",
          "aspect_ratio": "1:1",
          "output_format": "jpeg"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Aufgabendetails abrufen

GET https://api.hiapi.ai/v1/tasks/:id

Antwortfelder

taskIdstringPflicht

Aufgaben-ID, stets mit Präfix tk-hiapi-.

modelstringPflicht

Aufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.

routestringOptional

Erscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.

statusstringPflicht

Aufgabenstatus.

Statuswerte

queued Eingereiht, noch nicht gestartet. handling In Verarbeitung. archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet. success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben). fail Endzustand: fehlgeschlagen (error wird zurückgegeben). Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.

creatednumberPflicht

Zeitpunkt der Aufgabenerstellung (Unix-Sekunden).

completednumberPflicht

Unix-Sekunden des Endzustands; vor Abschluss stets 0.

outputarrayOptional

Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).

Array [ object ]

Array-Elemente

urlstringPflicht

Artefakt-URL, direkt herunterladbar.

typestringPflicht

Aktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.

expireAtnumberPflicht

Unix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.

errorobjectOptional

Nur bei status == fail.

codestringPflicht

Business-Fehlercode.

messagestringPflicht

Fehlerbeschreibung.

Antwortbeispiele

Erfolg

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In Bearbeitung (nicht final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fehlgeschlagen

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}