Endpoint /v1/images/generations: Einstieg
Auf dieser Seite
Lektion am 3. November 2026 abgeschlossen basierend auf der Seite Bildgenerierung und der xAI Images API-Referenz: Standardwerte (
aspect_ratioaufauto,resolutionauf1k),quality-Parameter für Imagine 2.0 und JPEG als Standardformat. Quellen: Bildgenerierung · Images API.
Erstellen Sie Ihr erstes Bild mit der Grok API
Die xAI API bietet einen dedizierten Endpunkt für die Bildgenerierung: POST /v1/images/generations. Mit diesem Endpunkt können Sie Bilder aus einer Textbeschreibung mithilfe von Grok Imagine-Modellen erstellen. Ob Sie Illustrationen, Marketing-Materialien oder kreative Prototypen erstellen möchten – alles beginnt mit diesem Endpunkt.
In dieser Lektion erfahren Sie, wie Sie eine Bildgenerierungsanfrage strukturieren, und verstehen die grundlegenden Parameter.
Struktur einer Generierungsanfrage
Zwei Parameter reichen aus, um ein Bild zu generieren: das Modell und den Prompt. Alle anderen Parameter haben Standardwerte, sodass Sie mit drei Zeilen ein erstes Ergebnis erhalten – und genau das sollten Sie tun, bevor Sie den Rest lesen, damit Sie ein Bild vor sich haben, an das Sie jeden Parameter knüpfen können.
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
response = client.images.generate(
model="grok-imagine-image",
prompt="Ein bretonischer Leuchtturm unter einem sternklaren Himmel, Aquarellstil"
)
image_url = response.data[0].url
print(image_url)
Die xAI API ist mit dem OpenAI SDK für die Bildgenerierung kompatibel: Sie richten die base_url auf https://api.x.ai/v1, ein, geben Ihren xAI-Schlüssel an, und der Rest Ihres Codes bleibt unverändert. Halten Sie den Geltungsbereich dieser Kompatibilität im Blick – sie gilt für die Generierung, jedoch nicht für das Bearbeiten, das ein anderes Format erwartet. Lektion 5 behandelt dies.
Anfrageparameter
Hier sind die Parameter, die Sie in Ihrer Anfrage angeben können:
model: das zu verwendende Generierungsmodell (grok-imagine-imageodergrok-imagine-image-2.0, siehe Lektion 2)prompt: die Textbeschreibung des gewünschten Bildesn: die Anzahl der zu generierenden Bilder (1 bis 10, Standard: 1)aspect_ratio: das Seitenverhältnis des Bildes (autoals Standard: das Modell wählt basierend auf dem Prompt)resolution: die Auflösung (1kals Standard oder2k)quality:low,mediumoderauto(Standard) auf Imagine 2.0, siehe Lektion 12response_format:url(Standard) oderb64_json, um das Bild im Base64-Format zu erhalten
Beispiel mit allen Parametern
response = client.images.generate(
model="grok-imagine-image",
prompt="Ein magischer Wald mit Glühwürmchen, digitaler Kunststil",
n=2,
response_format="url",
extra_body={"aspect_ratio": "16:9", "resolution": "2k"},
)
for image in response.data:
print(image.url)
Antwortformat
Die Antwort ist immer ein Array, auch bei einem einzelnen Bild – iterieren Sie darüber, statt data[0] auszuwerten, sonst wird Ihr Code brechen, sobald Sie n=4 setzen. Jedes Objekt enthält:
url: die temporäre URL des Bildes (fallsresponse_formataufurlgesetzt ist)b64_json: die Base64-Daten des Bildes (fallsresponse_formataufb64_jsongesetzt ist)
Der zurückgegebene MIME-Typ kann image/png, image/jpeg oder image/webp sein; er ist standardmäßig image/jpeg, es sei denn, eine Qualitätseinstellung erzeugt ein PNG.
Praktische Übung
Versuchen Sie, Ihr erstes Bild zu generieren, indem Sie den Prompt an Ihren beruflichen Kontext anpassen. Zum Beispiel für ein Präsentationsbild:
response = client.images.generate(
model="grok-imagine-image",
prompt="Minimalistisches Diagramm zur Darstellung des Startup-Wachstums, "
"blaue und weiße Farben, dunkler Hintergrund, flaches Design",
extra_body={"resolution": "2k", "aspect_ratio": "16:9"},
)
Kernaussagen
- Der Generierungs-Endpunkt ist
POST /v1/images/generations - Zwei Parameter reichen zum Starten aus:
modelundprompt - Die API ist mit dem OpenAI Python SDK kompatibel, indem Sie die
base_urländern - Sie können bis zu 10 Bilder pro Anfrage generieren
- Die verfügbaren Auflösungen sind
1k(Standard) und2k