Seitenverhältnisse, Auflösungen und Ausgabeformate
Auf dieser Seite
Aktualisiert am 2. November 2026 — Imagine.
grok-imagine-image-qualitywurde zum 2. November 2026 entfernt (die Anfragen werden ab diesem Datum inlow-Qualität von Imagine 2.0 bedient): Beispiele verwenden nungrok-imagine-image(Imagine 1.0) undgrok-imagine-image-2.0(Imagine 2.0,low,mediumoderauto-Qualität). Mit dem OpenAI SDK werdenaspect_ratio,resolutionundqualityüberextra_bodyübermittelt, und Bearbeitungen erfolgen über das xAI SDK oder eine HTTP-Anfrage.
Beherrschung Ihrer Bildabmessungen
Das gewählte Seitenverhältnis und die Auflösung bestimmen direkt das Erscheinungsbild und die Verwendung Ihrer generierten Bilder. Die Grok Imagine API bietet erhebliche Flexibilität mit zahlreichen vordefinierten Verhältnissen und zwei Auflösungsebenen.
Verfügbare Seitenverhältnisse
Wählen Sie das Verhältnis basierend auf dem Zielmedium und wählen Sie es vor der Generierung. Das Zuschneiden eines quadratischen Bildes zu einem Panorama-Banner nachträglich schneidet in die vom Modell für ein Quadrat erstellte Komposition ein: Das Motiv rückt außermittig, Ränder verschwinden. Die direkte Generierung im richtigen Format kostet dasselbe und liefert ein Bild, das für seine Proportionen konzipiert wurde.
| Verhältnis | Ausrichtung | Typische Verwendung |
|---|---|---|
| 1:1 | Quadrat | Profile, Icons, Instagram |
| 16:9 | Breites Panorama | Präsentationen, Banner, Video |
| 9:16 | Vertikales Porträt | Stories, Reels, TikTok |
| 4:3 | Klassisches Panorama | Traditionelle Fotos, Dokumente |
| 3:4 | Porträt | Plakate, Buchcover |
| 3:2 / 2:3 | Standardfoto | Fotodrucke, Postkarten |
| 2:1 / 1:2 | Ultra breit / ultra vertikal | Web-Banner, Panoramen |
| auto | Automatisch | Modell wählt optimales Verhältnis |
Zusätzliche Verhältnisse stehen auch für spezifische Fälle wie Smartphone-Bildschirme zur Verfügung: 9:19.5, 19.5:9, 9:20 und 20:9.
Auflösungen: 1k vs. 2k
Zwischen 1k und 2k ist die Frage nicht „welche ist die beste”, sondern „wo wird dieses Bild betrachtet”. Auf einem Bildschirm ist der Unterschied für die überwältigende Mehrheit der Webanwendungen unsichtbar, und 2k kostet lediglich zusätzliche Generierungszeit. Für den Druck wird dies jedoch kritisch, wo die Anzahl der Pixel pro Zentimeter die wahrgenommene Schärfe direkt bestimmt.
1k: Standardauflösung, geeignet für die meisten Webanwendungen. Schnellere Generierungszeit.2k: Hohe Auflösung, ideal für Druck oder visuelle Darstellungen, die viele Details erfordern.
# Standardauflösung für das Web
response_web = client.images.generate(
model="grok-imagine-image",
prompt="Neon-stylisiertes Mobile-App-Icon",
extra_body={"resolution": "1k", "aspect_ratio": "1:1"},
)
# Hohe Auflösung für den Druck
response_print = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Art-Deco-Konzertplakat mit eleganter Typografie",
extra_body={"resolution": "2k", "aspect_ratio": "3:4"},
)
Ausgabeformate
Der Parameter response_format bestimmt, wie das Bild an Sie zurückgegeben wird:
Temporäre URL (Standard)
response = client.images.generate(
model="grok-imagine-image",
prompt="Astronaut-Katze",
response_format="url"
)
# response.data[0].url → Temporäre URL, zum schnellen Download
Base64-JSON
import base64
response = client.images.generate(
model="grok-imagine-image",
prompt="Astronaut-Katze",
response_format="b64_json"
)
image_bytes = base64.b64decode(response.data[0].b64_json)
with open("astronaut_cat.png", "wb") as f:
f.write(image_bytes)
Das entscheidende Wort ist temporär: Die zurückgegebene URL läuft ab. Eine Anwendung, die die URL in einer Datenbank speichert und Wochen später anzeigt, wird auf defekte Bilder stoßen, oft lange nach der Bereitstellung. Zwei Optionen funktionieren: Laden Sie das Bild von der URL sofort herunter oder fordern Sie Base64 direkt an – in beiden Fällen muss das Bild auf Ihrem eigenen Speicher landen.
Die richtige Kombination wählen
Für jeden Anwendungsfall finden Sie hier die empfohlenen Kombinationen:
- Instagram-Beitrag:
1:1, Auflösung1k, Imagine 1.0 - Story/Reel:
9:16, Auflösung1k, Imagine 1.0 - Web-Banner:
16:9oder2:1, Auflösung1k, Imagine 1.0 - Veranstaltungsplakat:
3:4, Auflösung2k, Imagine 2.0 inmedium-Qualität - Artikelillustration:
16:9, Auflösung2k, Imagine 2.0 inmedium-Qualität
Kernaussagen
- Über 10 Seitenverhältnisse verfügbar, plus
auto-Modus - Zwei Auflösungen:
1k(schnell, Web) und2k(detailliert, Druck) - Zwei Ausgabeformate:
url(temporär) undb64_json(dauerhaft) - Zurückgegebene MIME-Typen können PNG, JPEG oder WebP sein
- Passen Sie das Verhältnis an den Verteilungskanal Ihres Bildes an