xAI: Grok Imagine Image 2.0
Grok Imagine Image 2.0 erstellt Bilder aus schriftlichen Briefings und bearbeitet vorhandene Bilder über natürlichsprachliche Anweisungen. xAI dokumentiert einstellbare Qualität, Auflösung und Komposition, mehrere Bildreferenzen, 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 Bildgenerierung und -bearbeitung. Es nimmt eine schriftliche Beschreibung oder eine Beschreibung gemeinsam mit Quellbildern entgegen und liefert ein Bildergebnis. Das ausdrücklich benannte 2.0-Profil des Herstellers deckt die Erstellung einer Szene, die Änderung eines vorhandenen Bildes, die Kombination von Motiven aus Referenzen und die Transformation des visuellen Stils ab. 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 das Hauptmotiv, seine Umgebung, die Komposition, Beleuchtung und visuelle Gestaltung. Benennen Sie, was Betrachter zuerst wahrnehmen sollen und wo das Bild eingesetzt wird. Für ein Produktkonzept kann ein beispielhaftes Briefing eine keramische Schreibtischlampe auf einem hellen Steintisch, weiches Fensterlicht, eine Nahansicht des Materials und Freiraum für eine separate Überschrift beschreiben. Geben Sie bei einer Illustration Figuren, Handlung und gewünschte Ästhetik an, statt zu erwarten, dass ein einzelnes Stilwort die gesamte Szene festlegt.
Der Hersteller dokumentiert ein bis zehn Ausgabebilder pro Generierungsanfrage; der Standardwert ist eins. Mehrere Ergebnisse aus demselben Briefing liefern Alternativen zur Prüfung, garantieren aber kein identisches Motiv in jeder Variante. Prüfen Sie Motiv, Komposition und wichtige Details und behalten Sie die Version, die am besten zum Briefing passt. Bewahren Sie Briefing und ausgewählte Variante zusammen auf, damit spätere Bearbeitungen die gewünschte Komposition verwenden.
Komposition, Auflösung und Qualität
Der Generierungsleitfaden dokumentiert eine automatische Seitenverhältniswahl oder ein ausdrücklich vorgegebenes 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 geplanten Platzierung: quadratisch für eine kompakte Kachel, Hochformat für eine vertikale Komposition oder Querformat für eine breite Szene. Geben Sie das beschnittempfindliche Motiv und den vom Layout benötigten Raum 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 Steuerung mit den Optionen low, medium und auto. Im aktuellen xAI-Leitfaden ist auto der Standardwert und verwendet low für die Generierung sowie medium für die Bearbeitung; eine ausdrückliche Einstellung von low oder medium legt diese Auswahl fest. Auflösung und Qualität beschreiben somit unterschiedliche Steuerelemente. Benennen Sie die wichtigen visuellen Details und kontrollieren Sie sie im zurückgegebenen Bild, statt eine der Einstellungen als Garantie für exakte Schrift, Geometrie oder Motiverhaltung zu betrachten.
Bearbeitung und Übertragung visueller Stile
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 verlangen, eine dunkle Wand durch eine helle Putzoberfläche zu ersetzen und dabei Möbelanordnung, Kamerablickwinkel und warme Beleuchtung zu erhalten. Wenn eine stilistische Transformation beabsichtigt ist, geben Sie die gewünschte Gestaltung an: Der Hersteller zeigt Fotografie, Anime, Ölmalerei, Aquarell, Pop-Art und Bleistiftskizzen. Benennen Sie, welche Elemente ihr Erscheinungsbild behalten sollen und welche sich mit der Gestaltung ändern dürfen.
Der Bearbeitungsablauf des Herstellers akzeptiert eine Quellbildreferenz, 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 einen Möbelaustausch und eine anschließende Lichtanpassung zu einem spezifischeren Ergebnis entwickeln. Ordnen Sie Original und ausgewähltes Zwischenbild jedem Briefing zu, damit eine spätere Verfeinerung anhand der gewünschten Komposition geprüft werden kann.
Mehrere Referenzen kombinieren
Der aktuelle Leitfaden für mehrere Bilder erlaubt bis zu fünf Quellbilder in einer Bearbeitung. Beziehen Sie sich auf sie in der bereitgestellten Reihenfolge 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 und kann durch eine ausdrückliche Verhältnisangabe überschrieben werden. Beschreiben Sie für das Konzept eines Produkts in einem Raum Position, Größe und Kontakt des Produkts mit den Raumoberflächen und fordern Sie anschließend die Erhaltung der identifizierenden Details an. 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 außerdem die Ausgabe kodierter Bilder. Sichern Sie das tatsächliche Bild zeitnah, wenn es als Asset benötigt wird. Sein optionaler verzögerter Ablauf trennt die Bestätigung einer Anfrage von deren Abschluss: Auf eine Anfragekennung folgt der Status pending, done oder failed; verzögerte Ergebnisse verwenden das Adress-Antwortformat mit einer dokumentierten Aufbewahrungsdauer von 24 Stunden. Eine übermittelte Anfrage oder der Status pending ist kein fertiges Bild. Bewahren Sie das abgeschlossene Bild mit seinem Briefing und den gewählten Einstellungen für spätere Wiederverwendung auf.
Ein brauchbares fertiges Artefakt ist ein Bild, das zu einer festgelegten Szene, einem Layout oder einem Bearbeitungsbriefing passt. Prüfen Sie die vollständige Komposition und ihre kleinen Details, besonders das Quellmotiv, Objektgrenzen, Proportionen und jede bedeutungstragende Schrift. Ändern Sie bei iterativer Arbeit die Anweisung zum sichtbaren Problem und verwenden Sie das ausgewählte Ergebnis als nächste Referenz. Halten Sie gewünschte Änderung und Erhaltungsvorgaben konkret, damit jedes Ergebnis anhand eines bestimmten kreativen Zwecks beurteilt 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 über natürlichsprachliche Anweisungen. xAI dokumentiert einstellbare Qualität, Auflösung und Komposition, mehrere Bildreferenzen, 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 |
|---|---|---|---|---|
| KonfigurationBasistarife für Tokens | 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 · In Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · In 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 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