Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Endpoint /v1/images/generations: Einstieg

Lektion 1 von 14 Aktualisiert am 3. November 2026 Anfänger
Auf dieser Seite
  1. Erstellen Sie Ihr erstes Bild mit der Grok API
  2. Struktur einer Generierungsanfrage
  3. Anfrageparameter
  4. Antwortformat
  5. Praktische Übung
  6. Kernaussagen

Lektion am 3. November 2026 abgeschlossen basierend auf der Seite Bildgenerierung und der xAI Images API-Referenz: Standardwerte (aspect_ratio auf auto, resolution auf 1k), quality-Parameter für Imagine 2.0 und JPEG als Standardformat. Quellen: Bildgenerierung · Images API.

Erstellen Sie Ihr erstes Bild mit der Grok API

Von Grok generiertes Bild 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.

1
Generierungs-Endpunkt
2
Verfügbare Modelle
10
Maximale Bilder pro Anfrage
2k
Maximale Auflösung

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-image oder grok-imagine-image-2.0, siehe Lektion 2)
  • prompt: die Textbeschreibung des gewünschten Bildes
  • n: die Anzahl der zu generierenden Bilder (1 bis 10, Standard: 1)
  • aspect_ratio: das Seitenverhältnis des Bildes (auto als Standard: das Modell wählt basierend auf dem Prompt)
  • resolution: die Auflösung (1k als Standard oder 2k)
  • quality: low, medium oder auto (Standard) auf Imagine 2.0, siehe Lektion 12
  • response_format: url (Standard) oder b64_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 (falls response_format auf url gesetzt ist)
  • b64_json: die Base64-Daten des Bildes (falls response_format auf b64_json gesetzt 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: model und prompt
  • 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) und 2k