xAI
Grok Imagine Quality
grok-imagine-quality/image-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 ausprobieren
Eingabe
Galerie
Alle Arbeiten ansehenAusgabe
imagePreise
grok-imagine-quality/image-to-image per image
| Spezifikationen | Einzelpreis |
|---|---|
| 1K | $0.080 |
| 2K | $0.100 |
Positionierung und Kurzprofil
grok-imagine-quality/image-to-image ist die hochauflösende Variante von xAI für die Bildbearbeitung. Sie nimmt 1 bis 3 Referenzbilder und eine Bearbeitungsanweisung entgegen und liefert ein fertiges Bild in 1K- oder 2K-Auflösung. Im Vergleich zur Standardversion ist sie bei Detailschärfe, Textur und Beleuchtung, der Textdarstellung im Bild sowie der Kompositionsstabilität einen Schritt weiter – auf Kosten einer etwas langsameren Generierung. Sie eignet sich für Entwickler, die Ergebnisse in Produktionsqualität benötigen und gezielte Änderungen auf Basis von Referenzbildern vornehmen möchten, etwa für kommerzielle Visuals, Social-Media-Grafiken und Layout-Aufträge.
Zentrale Highlights
- Hochauflösende Bearbeitung, stabilere Details und Komposition – im Vergleich zur Standardversion wirken Textur, Beleuchtung und physikalische Darstellung natürlicher, die Komposition ist stabiler und das Ergebnis direkt lieferbar statt nur ein Entwurf.
- Zwei Ausgabestufen: 1K und 2K – dieselbe Schnittstelle bietet entweder schnelle 1K-Iterationen oder 2K-Feinarbeit und deckt damit sowohl kreatives Ausprobieren als auch das finale Produkt ab.
- Mehrere Referenzbilder und steuerbares Seitenverhältnis – bis zu 3 Referenzbilder, wahlweise auto oder 13 feste Seitenverhältnisse; auto übernimmt das Verhältnis des ersten Referenzbilds.
- Genauere Textdarstellung im Bild – die Wiedergabetreue von Text in Layout-Grafiken ist verbessert, ideal für Ausgaben mit Textinhalten wie Poster und Social-Grafiken.
Funktionsbeschreibung
Gezielte Bearbeitung mit Referenzbildern: Mit 1 bis 3 Referenzbildern und einer natürlichsprachlichen Bearbeitungsanweisung lassen sich gezielte Änderungen am Bild vornehmen, während Motiv und Stil konsistent bleiben.
Steuerung von Auflösung und Seitenverhältnis: Unterstützt die zwei Auflösungsstufen 1K und 2K; das Seitenverhältnis ist wahlweise auto oder ein gängiges Hoch- bzw. Querformat. Der auto-Modus übernimmt das Verhältnis des ersten Referenzbilds und erleichtert die Anpassung an verschiedene Platzierungen.
Ausgabe in mehreren Formaten: Das Ausgabeformat ist wahlweise jpeg, png oder webp und passt direkt zu den Dateityp-Anforderungen nachgelagerter Verarbeitungsketten.
Bearbeitung mit langen Anweisungen: Bearbeitungsanweisungen unterstützen bis zu 8000 Zeichen und können komplexere Änderungsabsichten mit mehreren Elementen beschreiben.
Wiedergabe benannter Motive: Die Genauigkeit bei der Wiedergabe benannter Motive wie Marken, Personen des öffentlichen Lebens oder konkreter Orte ist hoch; Objekte können in der Anweisung direkt benannt werden.
Anwendungsfälle
- E-Commerce- und Werbeteams bearbeiten Produktbilder – mit Produktfotos als Referenz werden Hintergrund, Licht und Komposition nach Beschreibung angepasst und Visuals in Produktionsqualität erzeugt, die direkt ausgespielt werden können.
- Designer erstellen Poster und Social-Media-Grafiken – auf Basis vorhandener Layout-Referenzbilder werden Grafiken mit Textlayout generiert und als 2K-Ausgabe für Event-Poster oder Social-Media-Veröffentlichungen ausgegeben.
- Kreativteams iterieren von der Skizze zur Feinarbeit – zunächst mit 1K schnell die Richtung prüfen, dann mit 2K die Endfassung ausgeben, um den Zyklus vom Konzepttest bis zur Lieferung zu verkürzen.
- Serienbilder mit konsistentem Stil – mit demselben Referenzbild als Bedingung werden mehrere Bilder generiert, die Stil und Motiv einheitlich halten, für die serielle Content-Produktion.
Einschränkungen und Auswahlhinweise
Dies ist eine Bildbearbeitungsstrecke: Es muss mindestens 1 öffentlich zugängliches Referenzbild in jpeg, png oder webp bereitgestellt werden; SVG wird nicht unterstützt. Für reine Text-zu-Bild-Anforderungen ist sie daher nicht geeignet – in solchen Fällen sollte die Text-zu-Bild-Strecke derselben Serie gewählt werden. Bearbeitungsanweisungen umfassen maximal 8000 Zeichen, pro Vorgang werden höchstens 3 Bilder referenziert. Der Fokus liegt auf Qualität, die Generierung ist langsamer als bei der Standardversion; bei hoher Auflösung oder Aufgaben mit fein abzustimmenden Referenzbildern sind möglicherweise mehrere Versuche nötig, um das gewünschte Ergebnis zu erzielen. Es wird ausschließlich Bildausgabe unterstützt, andere Modalitäten wie Video werden nicht abgedeckt.
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
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringPflichtAccount-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen
Content-TypestringOptionalDer 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-KeystringOptionalIdempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.
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
modelstringPflichtAktueller Festwert: grok-imagine-quality/image-to-image
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für grok-imagine-quality/image-to-image und Route default — siehe Parametertabelle unten.
promptstringPflichtminLength 1maxLength 8000Text der Bildbearbeitungsanweisung, der den gewünschten Ausgabeeffekt beschreibt; liegt als Zeichenkette vor und bestimmt unmittelbar die Bearbeitungsrichtung.
image_urlsarrayPflichtminItems 1maxItems 3Array der eingegebenen Referenzbilder; die Elemente sind öffentlich zugängliche Bild-URLs, unterstützt werden die Formate jpeg/png/webp, SVG wird nicht unterstützt; die Anzahl liegt zwischen 1 und 3 Bildern.
Array [ string ]
resolutionstringOptionalStandard: "1k"Auflösung des Ausgabebilds, liegt als Zeichenkette vor; Standard ist 1k.
1k2kaspect_ratiostringOptionalStandard: "auto"Seitenverhältnis des generierten Bilds, liegt als Zeichenkette vor; bei der Einstellung auto wird das Seitenverhältnis des ersten eingegebenen Bilds übernommen; Standard ist auto.
auto2:120:919.5:916:94:33:21:1Alle anzeigen (6)
2:33:49:169:19.59:201:2output_formatstringOptionalStandard: "jpeg"Format des Ausgabebilds, liegt als Zeichenkette vor; Standard ist jpeg.
jpegpngwebpcallbackobjectOptional
Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.
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.
urlstringPflichtPflicht, 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.
finalstoragestringOptionalStandard: "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.
temppersistentAnfragebeispiele
# 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/image-to-image",
"input": {
"prompt": "…",
"image_urls": "…",
"resolution": "1k",
"aspect_ratio": "auto",
"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/image-to-image",
input: {
"prompt": "…",
"image_urls": "…",
"resolution": "1k",
"aspect_ratio": "auto",
"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/image-to-image",
"input": {
"prompt": "…",
"image_urls": "…",
"resolution": "1k",
"aspect_ratio": "auto",
"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
https://api.hiapi.ai/v1/tasks/:id Antwortfelder
taskIdstringPflichtAufgaben-ID, stets mit Präfix tk-hiapi-.
modelstringPflichtAufgelö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.
routestringOptionalErscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.
statusstringPflichtAufgabenstatus.
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.
creatednumberPflichtZeitpunkt der Aufgabenerstellung (Unix-Sekunden).
completednumberPflichtUnix-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
urlstringPflichtArtefakt-URL, direkt herunterladbar.
typestringPflichtAktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.
expireAtnumberPflichtUnix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.
errorobjectOptional
Nur bei status == fail.
codestringPflichtBusiness-Fehlercode.
messagestringPflichtFehlerbeschreibung.
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"
}
}
} Artikel
Alle Artikel ansehen →-
Tutorial
So rufen Sie hailuo-2.3/text-to-video über die HiAPI API auf: curl, Python und lauffähige Anfragebeispiele
-
Tutorial
kandinsky-6.0-pro/image-to-video auf HiAPI: Tutorial mit curl und Python
Eine funktionierende Bild-zu-Video-Anfrage auf HiAPI ausführen: vom Upload des ersten Frames über asynchrones Polling bis zum finalen Download
-
Tutorial
So nutzt du kling-4.0/text-to-video über die HiAPI-API: curl, Python und ein lauffähiges Anforderungsbeispiel
Ein praxisnaher Leitfaden für Entwickler: filmische Prompts, synchrones Audio, asynchrones Polling und Download der Ausgabe
-
Tutorial
So rufen Sie hailuo-2.3-fast/image-to-video über die HiAPI API auf: curl und Python in der Praxis
Die erste lauffähige Anfrage für die schnelle, kostengünstige Bild-zu-Video-Stufe – von der Modell-ID bis zum heruntergeladenen MP4
-
Tutorial
Kandinsky 6.0 Pro Text-zu-Video auf HiAPI: curl- und Python-Tutorial
Eine anfrageorientierte praktische Demonstration: Aufbau des Aufrufs vom Prompt zum Videoclip, Absenden der Anfrage, Abfragen des Fertigstellungsstatus und Herunterladen des Ergebnisses
Ähnliche Modelle
Alle Modelle ansehen →Gleicher Typ
-
GPT Image 2.5 OpenAI $0.017 /Bild -
Ideogram V4 Ideogram $0.050 /Bild -
Z-Image Alibaba $0.008 /Bild -
GPT Image 2 OpenAI $0.007 /Bild -
Muse Image 1.0 Meta $0.015 per task -
Qwen Image 2.1 Alibaba $0.020 /Bild -
Recraft V4.1 Recraft $0.010 /Bild -
FLUX 3 Image Black Forest Labs $0.041 /Bild -
FLUX.1 Schnell Black Forest Labs $0.005 /Bild -
Nano Banana Google $0.021 /Bild -
Nano Banana 2 Google $0.036 /Bild -
FASHN Tryon v1.6 FASHN $0.107 /Bild







