Entwickler-Ressourcen

Grok 5 Imagine API Dokumentation

Integrieren Sie das xAI Grok 5 Imagine Modell in Ihre Anwendungen. Unterstützung für Text-zu-Bild, Text-zu-Video und Bild-zu-Video Generierung mit einer einfachen REST-API.

Authentifizierung

Die Grok 5 Imagine API verwendet Bearer-Token-Authentifizierung. Übergeben Sie Ihren API-Schlüssel im Request-Header.

Authentifizierung

Authorization: Bearer sk-your-api-key-here

Halten Sie Ihren API-Schlüssel sicher. Geben Sie ihn nicht im clientseitigen Code weiter.

Preise

Typ	Kosten	Beschreibung
Text-zu-Bild `(text2img)`	5 Credits	Bilder aus Text-Prompts mit Grok 5 AI generieren.
Text-zu-Video `(text2video)`	24 Credits	Videos aus Text-Prompts mit Grok 5 AI generieren.
Bild-zu-Video `(img2video)`	24 Credits	Videos aus Bildern mit Grok 5 AI generieren.

Aufgabe erstellen

POSThttps://grok5ai.com/api/generate

Asynchrone Generierung

Preise

Credits variieren je nach Modell: text2img kostet 5 Credits, text2video und img2video kosten jeweils 24 Credits.

Starten Sie eine Generierungsaufgabe. Die API gibt sofort eine task_id zurück, mit der Sie den Status abfragen können.

Body-Parameter

Parameter	Typ	Erforderlich	Beschreibung
model	string	Erforderlich	Zu verwendendes Modell: text2img, text2video oder img2video.
prompt	string	Bedingt	Die Textbeschreibung für die Generierung. Max. 5000 Zeichen. Erforderlich für text2img und text2video.
image_urls	array	Bedingt	Array von Bild-URLs für den img2video-Modus. Erforderlich, wenn task_id nicht angegeben ist.
task_id	string	Bedingt	Task-ID einer vorherigen Generierung als Eingabebild. Erforderlich, wenn image_urls nicht angegeben ist.
callback_url	string	Optional	Webhook-URL für die Benachrichtigung bei Aufgabenerledigung.

Beispielanfragen

Text-zu-Bild Beispiel (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text2img",
    "prompt": "A serene mountain landscape at sunset"
  }'

Text-zu-Video Beispiel (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text2video",
    "prompt": "A timelapse of clouds moving over mountains"
  }'

Bild-zu-Video Beispiel (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "img2video",
    "image_urls": ["https://example.com/image.jpg"]
  }'

Erfolgreiche Antwort

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "IN_PROGRESS"
  }
}

Fehlerantwort

{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}

Status prüfen

GEThttps://grok5ai.com/api/status

Fragen Sie diesen Endpunkt ab, um den Fortschritt Ihrer Aufgabe zu überprüfen. Wir empfehlen eine Abfrage alle 5-10 Sekunden.

Abfrageparameter

Parameter	Typ	Beschreibung
task_id	string	Die vom Generierungs-Endpunkt erhaltene Task-ID. Erforderlich

Statuswerte

PENDINGAufgabe in der Warteschlange

IN_PROGRESSIn Bearbeitung

SUCCESSAbgeschlossen

FAILEDFehler aufgetreten

cURL

curl -X GET "https://grok5ai.com/api/status?task_id=grok5abc123def456img" \
  -H "Authorization: Bearer YOUR_API_KEY"

Antwort (In Bearbeitung)

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "IN_PROGRESS",
    "consumed_credits": 10,
    "created_at": "2024-12-19T10:00:00Z"
  }
}

Antwort (Abgeschlossen)

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "SUCCESS",
    "response": [
      "https://cdn.example.com/image.png"
    ]
  }
}

Antwort (Fehlgeschlagen)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

Fehlercodes

Code	Beschreibung
200	Erfolg
400	Bad Request - Ungültige Parameter (fehlender Prompt, ungültiges Modell, etc.)
401	Unauthorized - Fehlender oder ungültiger API-Schlüssel
404	Not Found - Task-ID existiert nicht
500	Internal Server Error - Bitte versuchen Sie es erneut oder kontaktieren Sie den Support

Benötigen Sie Hilfe?

Besuchen Sie unseren Support-Kanal oder schreiben Sie uns eine E-Mail.

Support kontaktieren