Skip to main content
POST
Dies ist ein asynchroner Endpunkt. Nach erfolgreicher Übermittlung wird eine Task-ID zurückgegeben. Fragen Sie den Task-Status für das Endergebnis ab. Ohne image_urls erfolgt Text-zu-Bild; mit Referenzen Bildbearbeitung oder Mehrbildreferenz.

Modellfunktionen

Body

string
Standard:"grok-imagine-image-2.0"
erforderlich
Fester Wert: grok-imagine-image-2.0.
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
Anweisung zur Generierung oder Bearbeitung. Nach dem Trimmen nicht leer, maximal 8.000 Zeichen.
integer
Standard:"1"
Anzahl der Ausgaben: 110.
string
Standard:"auto"
Unterstützt 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.
string
Standard:"1k"
1k oder 2k.
string
Nur Text-zu-Bild: low oder medium (Standard). Nicht zusammen mit image_urls senden.
array
Ein bis drei Referenzbilder. Akzeptiert werden nur öffentlich erreichbare absolute HTTP(S)-URLs. Lokale Bilder zuerst mit POST /v1/uploads/images hochladen und anschließend die zurückgegebene url verwenden.

Asynchroner Task

Eine erfolgreiche Übermittlung liefert HTTP 202; die Task-ID steht in data.id. Verwenden Sie data.poll_url oder GET /v1/tasks/{task_id} bis completed oder failed.