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 konfigurierbare Qualität, Auflösung und Komposition, Referenzen aus mehreren Bildern, 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 zur Bildgenerierung und -bearbeitung. Es nimmt eine schriftliche Beschreibung oder eine Beschreibung zusammen mit Ausgangsbildern entgegen und liefert ein Bildergebnis. Das benannte 2.0-Profil des Herstellers umfasst das Erstellen einer Szene, das Ändern eines vorhandenen Bildes, das Zusammenführen von Motiven aus Referenzen und die Transformation des visuellen Stils. Entscheiden Sie zunächst, ob Sie eine neue Komposition oder eine konkrete Änderung an bereits vorhandenem Material benötigen.
Ein Bild aus einem Briefing erstellen
Beschreiben Sie Hauptmotiv, Umgebung, Komposition, Beleuchtung und visuelle Behandlung. Legen Sie fest, was Betrachtende zuerst wahrnehmen sollen und wo das Bild verwendet wird. Für ein Produktkonzept kann ein beispielhaftes Briefing eine keramische Schreibtischlampe auf einem hellen Steintisch, weiches Fensterlicht, eine Nahansicht des Materials und freien Platz für eine separate Überschrift beschreiben. Geben Sie für eine Illustration Figuren, Handlung und gewünschte Ästhetik an, statt zu erwarten, dass ein einziges Stilwort die ganze Szene definiert.
Der Hersteller dokumentiert ein bis zehn Ausgabebilder pro Generierungsanfrage mit eins als Standardwert. Mehrere Ergebnisse aus demselben Briefing bieten Alternativen zur Prüfung; sie garantieren kein identisches Motiv in jeder Variante. Prüfen Sie Motiv, Komposition und wichtige Details und behalten Sie dann die Version, die am besten zum Briefing passt. Bewahren Sie Briefing und ausgewählte Variante gemeinsam auf, damit spätere Bearbeitungen die beabsichtigte Komposition verwenden.
Komposition, Auflösung und Qualität
Der Generierungsleitfaden dokumentiert die automatische Auswahl des Seitenverhältnisses oder ein ausdrückliches Verhältnis. Zu den aufgeführten Optionen gehören 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 das Format passend zur vorgesehenen Platzierung: quadratisch für eine kompakte Kachel, hochkant für eine vertikale Komposition oder quer für eine breite Szene. Geben Sie das beschnittempfindliche Motiv und den benötigten Platz im Layout an, statt sich allein auf das Seitenverhältnis zu verlassen.
Die dokumentierten Einstellungen für die Generierungsauflösung sind 1k und 2k, mit 1k als Standard. Qualität ist eine separate Einstellung mit den Optionen low, medium und auto. In xAIs aktuellem Leitfaden ist auto der Standard und verwendet low für die Generierung und medium für die Bearbeitung; eine ausdrückliche Einstellung low oder medium legt diese Auswahl fest. Auflösung und Qualität beschreiben somit unterschiedliche Einstellungen. Benennen Sie wichtige visuelle Details und prüfen Sie sie im zurückgegebenen Bild, statt eine der Einstellungen als Garantie für exakte Schrift, Geometrie oder Motiverhaltung zu behandeln.
Bearbeiten und visuellen Stil übertragen
Liefern Sie das zu ändernde Bild und beschreiben Sie die gewünschte Änderung in Bezug auf seinen sichtbaren Inhalt. Eine gezielte Bearbeitung könnte verlangen, eine dunkle Wand durch eine helle Putzfläche zu ersetzen und dabei Möbelanordnung, Kamerablickwinkel und warme Beleuchtung zu erhalten. Wenn eine stilistische Transformation beabsichtigt ist, geben Sie die gewünschte Behandlung an: Der Hersteller zeigt Fotografie, Anime, Ölmalerei, Aquarell, Pop-Art und Bleistiftskizzen. Bestimmen Sie, welche Elemente ihr Erscheinungsbild behalten sollen und welche sich mit der Behandlung ändern dürfen.
Der Bearbeitungsablauf 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 auch aufeinanderfolgende Bearbeitungen: Nutzen Sie das Ergebnis einer Bearbeitung als Eingabe der nächsten. So kann eine Grundkomposition durch eine Möbeländerung und anschliessende Lichtanpassung zu einem spezifischeren Ergebnis werden. Halten Sie das Original und das gewählte Zwischenbild mit jedem Briefing verbunden, damit eine spätere Verfeinerung gegen die gewünschte Komposition geprüft werden kann.
Mehrere Referenzen kombinieren
Der aktuelle Leitfaden für mehrere Bilder erlaubt bis zu fünf Ausgangsbilder in einer Bearbeitung. Beziehen Sie sich in ihrer gelieferten Reihenfolge darauf und weisen Sie jedem eine klare Rolle zu, etwa das Motiv aus dem ersten Bild und die Umgebung aus dem zweiten. Das Ausgabeseitenverhältnis folgt standardmässig dem ersten Eingabebild und kann durch eine ausdrückliche Angabe überschrieben werden. Beschreiben Sie für ein Produkt-im-Raum-Konzept Position, Grösse und Kontakt des Produkts mit den Raumoberflächen und verlangen Sie dann, die identifizierenden Details zu erhalten. Prüfen Sie die Kombination der Vorlagen, statt anzunehmen, jedes Element sei unverändert übernommen worden.
Das Bild empfangen und aufbewahren
Der Hersteller liefert standardmässig eine temporäre Bildadresse und dokumentiert auch die Ausgabe kodierter Bilder. Sichern Sie das tatsächliche Bild zeitnah, wenn es als Bilddatei benötigt wird. Der optionale aufgeschobene Ablauf trennt die Anfragebestätigung vom Abschluss: Auf eine Anfragekennung folgt der Status pending, done oder failed; aufgeschobene Ergebnisse nutzen das Adress-Antwortformat mit einer dokumentierten Aufbewahrung von 24 Stunden. Eine eingereichte Anfrage oder der Status pending ist kein fertiges Bild. Bewahren Sie das abgeschlossene Bild mit seinem Briefing und den gewählten Einstellungen zur späteren Wiederverwendung auf.
Ein nützliches fertiges Artefakt ist ein Bild, das zu einem definierten Szenen-, Layout- oder Bearbeitungsbriefing passt. Prüfen Sie die gesamte Komposition und ihre kleinen Details, insbesondere das Ausgangsmotiv, Objektgrenzen, Proportionen und bedeutungstragende Schrift. Ändern Sie bei iterativer Arbeit die Anweisung zum sichtbaren Problem und nutzen Sie das gewählte Ergebnis als nächste Referenz. Halten Sie die gewünschte Änderung und die Vorgaben zur Erhaltung konkret, damit jedes Ergebnis an einem bestimmten kreativen Zweck gemessen werden kann.
Ailoot Ultra · Bilder POST /v1/images/generations x-ai/grok-imagine-image-2.0
x-ai/grok-imagine-image-2.0Einstieg
Grok Imagine Image 2.0 erstellt Bilder aus schriftlichen Briefings und bearbeitet vorhandene Bilder anhand natürlichsprachlicher Anweisungen. xAI dokumentiert konfigurierbare Qualität, Auflösung und Komposition, Referenzen aus mehreren Bildern, 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
- Eingabe
text,image- Ausgabe
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 |
|---|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationEingabebild | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Eingabebild | Gebühr Eingabe · Eingabebild · Schätzung nur zum Vergleich $0.02 pro Eingabebild |
| KonfigurationGeschätzte Erzeugungskosten | 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 abschliessenden 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