Skip to main content
POST
Dieser Endpunkt akzeptiert auch den Alias grok-imagine-1.5-ext, der grok-imagine-1.5-apimart entspricht und austauschbar ist.

Authorizations

string
erforderlich
Alle APIs erfordern Bearer-Token-AuthentifizierungAPI Key holen:Besuchen Sie die API-Key-VerwaltungsseiteIm Request-Header hinzufügen:

Body

string
Standard:"grok-imagine-1.5-apimart"
erforderlich
Name des BildgenerierungsmodellsUnterstützte Modelle:
  • grok-imagine-1.5-apimart - Grok Bildgenerierung und -bearbeitung (Alias grok-imagine-1.5-ext)
Beispiel:"grok-imagine-1.5-ext"
boolean
Standard:"false"
Legt fest, ob der Inhalt vor dem Absenden des Bildauftrags moderiert wird.
  • true: Prompts und Eingabebilder mit omni-moderation-latest prüfen
  • false oder nicht angegeben: keine Moderationsanfrage und damit keine zusätzlichen Moderationskosten oder Verzögerung (Standard)
string
erforderlich
Textbeschreibung für Bildgenerierung oder -bearbeitung
string[]
Liste der Referenzbild-URLs. Weglassen für Text-zu-Bild; angeben für Bildbearbeitung.
  • Dieses Modell unterstützt 1–5 Referenzbilder
  • Akzeptiert nur öffentlich erreichbare absolute http://- oder https://-URLs
  • Lokale Bilder zuerst mit POST /v1/uploads/images hochladen und anschließend die zurückgegebene url verwenden
string
Standard:"1:1"
Ausgabe-BildgrößeUnterstützte Formate:
  • 1:1 - Quadrat (Standard)
  • 16:9 - Querformat Breitbild
  • 9:16 - Hochformat
  • 3:2 - Querformat
  • 2:3 - Hochformat
integer
Standard:1
Anzahl der zu generierenden BilderBereich: 1-10 (mindestens 1, höchstens 10)⚠️ Hinweis: Als reine Zahl übergeben (z. B. 1), keine Anführungszeichen, sonst Fehler

Response

integer
Antwortstatuscode
array
Antwortdaten-Array

Anwendungsfälle

Fall 1: Text-zu-Bild

Fall 2: Text-zu-Bild (Größe & Anzahl)

Fall 3: Bildbearbeitung (Hintergrund)

Fall 4: Bildbearbeitung (Stil)

Offizielle Modelle

grok-imagine-image und grok-imagine-image-quality verwenden denselben asynchronen Task-Ablauf wie andere Bildmodelle. Fragen Sie nach der Übermittlung den Task-Status mit der zurückgegebenen Task-ID bis zum Abschluss oder Fehler ab.
Senden Sie für beide Modelle kein quality. Ohne image_urls erfolgt Text-zu-Bild; ein Bild aktiviert Einzelbildbearbeitung, mehrere Bilder dienen als mehrere Referenzen.

Anfrageparameter

Unterstützte aspect_ratio-Werte: 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.

Antwort bei Task-Erstellung

202
Verwenden Sie data.id oder data.poll_url, bis der Status completed oder failed erreicht.