xAI: Grok Imagine Image 2.0
Grok Imagine Image 2.0 erstellt Bilder aus schriftlichen Briefings und bearbeitet vorhandene Bilder anhand natürlichsprachlicher Anweisungen. xAI dokumentiert einstellbare Qualität, Auflösung und Komposition, Mehrbildreferenzen, Stilübertragung und iterative Verfeinerung.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Grok Imagine Image 2.0 ist xAIs Modell für Bilderzeugung und -bearbeitung. Es nimmt eine schriftliche Beschreibung oder eine Beschreibung zusammen mit Ausgangsbildern entgegen und liefert ein Bildergebnis. Das namentlich bezeichnete 2.0-Profil des Herstellers umfasst das Erstellen einer Szene, das Ändern eines vorhandenen Bildes, das Kombinieren von Motiven aus Referenzen und das Verändern des Bildstils. Entscheiden Sie zuerst, ob Sie eine neue Komposition oder eine bestimmte Änderung an bereits vorhandenem Material benötigen.
Ein Bild aus einem Briefing erstellen
Beschreiben Sie Hauptmotiv, Umgebung, Komposition, Beleuchtung und Bildgestaltung. Legen Sie fest, was der Betrachter zuerst wahrnehmen soll und wo das Bild verwendet wird. Für ein Produktkonzept kann ein beispielhaftes Briefing eine Keramik-Schreibtischlampe auf einem hellen Steintisch, weiches Fensterlicht, eine Nahansicht des Materials und Freiraum für eine separate Überschrift beschreiben. Geben Sie für eine Illustration Figuren, Handlung und beabsichtigte Ästhetik an, statt zu erwarten, dass ein einzelnes Stilwort die gesamte Szene definiert.
Der Hersteller dokumentiert ein bis zehn Ausgabebilder pro Generierungsanfrage, mit einem Bild als Standard. Mehrere Ergebnisse aus demselben Briefing liefern Alternativen zur Prüfung; sie garantieren kein identisches Motiv in jeder Variante. Prüfen Sie Motiv, Komposition und wichtige Details und bewahren Sie die Version auf, die am besten zum Briefing passt. Halten Sie Briefing und ausgewählte Variante zusammen, damit spätere Bearbeitungen die beabsichtigte Komposition verwenden.
Komposition, Auflösung und Qualität
Der Generierungsleitfaden dokumentiert eine automatische Seitenverhältniswahl oder ein ausdrücklich angegebenes Verhältnis. Aufgeführt sind 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, 21:9 und 5:2. Wählen Sie die Form passend zur vorgesehenen Platzierung: quadratisch für eine kompakte Kachel, Hochformat für eine vertikale Komposition oder Querformat für eine breite Szene. Geben Sie das zuschnittkritische Motiv und den vom Layout benötigten Freiraum an, statt sich allein auf das Seitenverhältnis zu verlassen.
Die dokumentierten Generierungsauflösungen sind 1k und 2k, mit 1k als Standard. Qualität ist ein separates Steuerelement mit den Optionen low, medium und auto. Im aktuellen xAI-Leitfaden ist auto die Standardeinstellung und verwendet low für die Generierung sowie medium für die Bearbeitung. Eine ausdrückliche Einstellung auf low oder medium legt diese Auswahl fest. Auflösung und Qualität beschreiben somit unterschiedliche Steuerelemente. Benennen Sie die wichtigen visuellen Details und prüfen Sie sie im zurückgegebenen Bild, statt eine der Einstellungen als Garantie für exakte Schrift, Geometrie oder den Erhalt des Motivs zu betrachten.
Bilder bearbeiten und Bildstile übertragen
Stellen Sie das zu ändernde Bild bereit und beschreiben Sie die gewünschte Änderung in Bezug auf seinen sichtbaren Inhalt. Eine gezielte Bearbeitung könnte eine dunkle Wand durch eine helle Putzfläche ersetzen und dabei Möbelanordnung, Kameraperspektive und warme Beleuchtung bewahren. Ist ein Stilwechsel beabsichtigt, geben Sie die gewünschte Gestaltung an: Der Hersteller zeigt Fotografie, Anime, Ölmalerei, Aquarell, Pop-Art und Bleistiftskizzen. Benennen Sie, welche Elemente ihr Aussehen behalten sollen und welche sich mit der Gestaltung ändern dürfen.
Der Bearbeitungsworkflow des Herstellers akzeptiert eine Ausgangsbildreferenz, kodierte Bilddaten oder eine Dateikennung. Verwenden Sie für gespeicherte Referenzen vollständig hochgeladene PNG-, JPEG- oder WebP-Bilder. Der Leitfaden dokumentiert außerdem aufeinanderfolgende Bearbeitungen: Verwenden Sie das Ergebnis einer Bearbeitung als Eingabe der nächsten. So lässt sich eine Grundkomposition durch eine Möbeländerung und eine anschließende Lichtanpassung zu einem spezifischeren Ergebnis entwickeln. Ordnen Sie jedem Briefing das Original und das ausgewählte Zwischenbild zu, damit eine spätere Verfeinerung gegen die beabsichtigte Komposition geprüft werden kann.
Mehrere Referenzen kombinieren
Der aktuelle Mehrbild-Leitfaden erlaubt bis zu fünf Ausgangsbilder in einer Bearbeitung. Beziehen Sie sich in der angegebenen Reihenfolge auf sie und geben Sie jedem eine klare Rolle, etwa das Motiv aus dem ersten Bild und die Umgebung aus dem zweiten. Das Ausgabeseitenverhältnis folgt standardmäßig dem ersten Eingabebild; ein ausdrücklich angegebenes Verhältnis kann es überschreiben. Beschreiben Sie für ein Produkt-im-Raum-Konzept Position, Größe und Kontakt des Produkts mit den Raumoberflächen und fordern Sie anschließend den Erhalt der identitätsprägenden Details. Prüfen Sie, wie die Quellen kombiniert wurden, statt anzunehmen, dass jedes Element unverändert kopiert wurde.
Das Bild empfangen und aufbewahren
Der Hersteller gibt standardmäßig eine temporäre Bildadresse zurück und dokumentiert auch eine kodierte Bildausgabe. Sichern Sie das tatsächliche Bild zeitnah, wenn es als Bilddatei benötigt wird. Der optionale aufgeschobene Workflow trennt die Empfangsbestätigung der Anfrage von ihrer Fertigstellung: Auf eine Anfragekennung folgt der Status pending, done oder failed. Aufgeschobene Ergebnisse verwenden das Adress-Antwortformat mit einer dokumentierten Aufbewahrungsdauer von 24 Stunden. Eine eingereichte Anfrage oder ein Status pending ist kein fertiges Bild. Bewahren Sie das fertige Bild zusammen mit Briefing und gewählten Einstellungen für spätere Wiederverwendung auf.
Ein nützliches finales Artefakt ist ein Bild, das zu einer definierten Szene, einem Layout oder einem Bearbeitungsbriefing passt. Prüfen Sie die vollständige Komposition und ihre kleinen Details, besonders das Ausgangsmotiv, Objektgrenzen, Proportionen und jede bedeutungstragende Schrift. Ändern Sie bei iterativer Arbeit die Anweisung, die zum sichtbaren Problem gehört, und verwenden Sie das ausgewählte Ergebnis als nächste Referenz. Halten Sie die gewünschte Änderung und die Erhaltungsvorgaben konkret, damit jedes Ergebnis gegen einen bestimmten kreativen Zweck beurteilt werden kann.
Ailoot Ultra · Bilder POST /v1/images/generations x-ai/grok-imagine-image-2.0
x-ai/grok-imagine-image-2.0Start
Grok Imagine Image 2.0 erstellt Bilder aus schriftlichen Briefings und bearbeitet vorhandene Bilder anhand natürlichsprachlicher Anweisungen. xAI dokumentiert einstellbare Qualität, Auflösung und Komposition, Mehrbildreferenzen, Stilübertragung und iterative Verfeinerung.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Bilder
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Bilder POST /v1/images/generations
- Eingabetypen
text,image- Ausgabetypen
image
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits x-ai/grok-imagine-image-2.0 | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 1K, 2K | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2, 9:19.5, 19.5:9, 9:20, 20:9, 1:2, 2:1, auto | Standard— |
Feldquality | Typstring | AnforderungOptional | Werte und Limits low, medium | Standard— |
Feldn | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 1 | Standard— |
Feldinput_references | Typarray | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 0 Maximale Anzahl Elemente: 3 | Standard— |
Feldprovider | Typobject | AnforderungOptional | Werte und Limits | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parametermaterial_types | Vertragtext, image |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · die tatsächlich zurückgegebene task_id oder ein Eintrag in der Medienbibliothek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Abrechnungseinheit | Gebühr |
|---|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationEingabebild | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Eingabebild | Gebühr Eingabe · Eingabebild · Schätzung nur zum Vergleich $0.02 pro Eingabebild |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungseinheit— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.08 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Bilder
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'x-ai/grok-imagine-image-2.0', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
Ergebnisse abrufen und speichern
Ailoot Ultra · Bilder
Laden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Abrufe anderer Inhalte
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.
Die vollständige Antwort und ihre Header, jede tatsächliche Ausgabe, die ursprünglich zurückgegebenen Kennungen und alle Nutzungsfelder aufbewahren. Den ursprünglichen Vorgang wiederaufnehmen, ohne die Erstellung erneut anzufordern.
Wenn die ursprüngliche Antwort geprüft werden muss
Die zurückgegebene X-Client-Request-ID zum Abgleich aufbewahren. Nur tatsächlich zurückgegebene task_id-/asset_id-Werte oder die eigene Medienbibliothek abfragen; niemals eine Aufgaben-URL aus der Vorgangs-ID bilden und die Erstellung niemals erneut anfordern.
Antwortfelder
| Feld | Typ |
|---|---|
Feldcreated | Typ |
Felddata[].url | Typ |
Felddata[].b64_json | Typ |
Feldusage | Typ |
Aliasnamen
Modellaliasnamen
Ailoot Ultra x-ai/grok-imagine-image-2.0
Aliasnamen für Methodenpfade
/v1/images
Zugehörige Aufrufer-IDs
FAQ · xAI: Grok Imagine Image 2.0
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/images/generations·x-ai/grok-imagine-image-2.0:text,image→image- Welche Felder verwendet die Anfrage?
POST /v1/images/generations·x-ai/grok-imagine-image-2.0:model,prompt,resolution,aspect_ratio,quality,n,input_references,provider- Welche Grenzen gelten?
POST /v1/images/generations·x-ai/grok-imagine-image-2.0:n.minimum:1;n.maximum:1