Grok 5 Imagine Generierung

API-Dokumentation

Verwenden Sie diese Endpunkte, um Grok 5 Imagine Jobs einzureichen und deren Status zu überprüfen. Jeder Aufruf verbraucht Kredite basierend auf dem verwendeten Modell.

Authentifizierung

Alle Anfragen müssen Ihren API-Schlüssel im Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Fehlende oder ungültige Schlüssel geben 401 Unauthorized.

POST

https://grok5imagine.com/api/generate

Generierungsaufgabe erstellen

Reicht einen neuen Grok 5 Imagine Job ein. Der Aufruf gibt sofort eine task_id zurück, während das Rendern asynchron abgeschlossen wird.

Parameter	Typ	Erforderlich	Beschreibung
model	string	Nein	Zu verwendendes Modell: grok-imagine/text-to-image (Standard), text-to-video, image-to-video oder upscale.
input	object	Ja	Eingabeparameter-Objekt mit prompt, image_urls oder task_id je nach Modell.
input.prompt	string (max 5000 chars)	Nein	Text-Prompt, der beschreibt, was generiert werden soll (erforderlich für text-to-image und text-to-video).
input.image_urls	string[]	Nein	Array von Bild-URLs (erforderlich für image-to-video).
input.task_id	string	Nein	Vorherige Aufgaben-ID für Upscale oder Image-to-Video-Generierung.
callback_url	string	Nein	Webhook-URL für Benachrichtigungen bei Aufgabenabschluss.
public	boolean	Nein	Die Aufgabe für öffentliche Galerien freigeben.

Kreditverbrauch

Kredite werden bei der Erstellung der Aufgabe abgezogen. Fehlgeschlagene Jobs werden automatisch erstattet.

Modell	Abgezogene Kredite
grok-imagine/text-to-image	5
grok-imagine/text-to-video	24
grok-imagine/image-to-video	24
grok-imagine/upscale	12

Beispielanfrage

{
  "model": "grok-imagine/text-to-image",
  "input": {
    "prompt": "A majestic dragon flying over a neon-lit cyberpunk city"
  }
}

Beispielantwort

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n31b6d54c8f4b4c4e8kie",
    "status": "IN_PROGRESS"
  }
}

GET / POST

https://grok5imagine.com/api/status

Aufgabenstatus überprüfen

Verwenden Sie diesen Endpunkt, um den neuesten Datensatz abzufragen. Wenn sich die Aufgabe noch im Status IN_PROGRESS befindet, fragen wir den Anbieter einmal zusätzlich ab, bevor wir antworten.

Parameter	Typ	Erforderlich	Beschreibung
task_id	string	Ja	ID, zurückgegeben von /generate. Senden Sie diese über Query-Parameter (?task_id=) oder den JSON-Body.

Feld	Beschreibung
task_id	Von /generate zurückgegebene ID.
status	SUCCESS (ERFOLG)
request	Bereinigte Kopie der eingereichten Payload.
response	Objekt mit resultUrls-Array, wenn der Status SUCCESS ist.
consumed_credits	Für die Aufgabe berechnete Kredite (0 bei Rückerstattung).
error_message	Anbieterfehler, wenn der Status FAILED ist.
created_at	UTC-Zeitstempel, wann der Job gespeichert wurde.

Beispielanfrage

GET https://grok5imagine.com/api/status?task_id=n31b6d54c8f4b4c4e8kie
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://grok5imagine.com/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "n31b6d54c8f4b4c4e8kie"
}

Beispielantwort

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n31b6d54c8f4b4c4e8kie",
    "status": "SUCCESS",
    "request": {
      "model": "grok-imagine/text-to-image",
      "input": {
        "prompt": "A majestic dragon flying over a neon-lit cyberpunk city"
      }
    },
    "response": {
      "resultUrls": [
        "https://static.gogloai.com/grok-imagine/image_001.png"
      ]
    },
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

Fehlerbehandlung

401 Unauthorized - Fehlender oder ungültiger API-Schlüssel.
402 Payment Required - Das Kreditguthaben konnte die Abbuchung nicht decken.
429 Too Many Requests - Reduzieren Sie die Abfragefrequenz oder die Anfragerate.
500 - Vorübergehendes Problem; versuchen Sie es mit exponentiellem Backoff erneut.