Grok Videos Generation API Integrationsanleitung

Dieser Artikel beschreibt die Integrationsanleitung für die Grok Videos Generation API, die Grok Imagine (xAI) Videos durch Eingabe von Text-Prompts, Eingabebildern und optionalen Referenzbildern generieren kann.

Antragsprozess

Um die Grok Videos Generation API zu nutzen, müssen Sie zunächst Ihr API-Token im Ace Data Cloud Dashboard abrufen und für zukünftige Verwendung aufbewahren.

Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, wo Sie sich registrieren und anmelden können. Nach Abschluss werden Sie automatisch zur aktuellen Seite zurückgeleitet. Ein API-Token reicht aus, um auf alle Dienste der Plattform zuzugreifen, es ist nicht erforderlich, für jeden Dienst separat zu beantragen. Bei der ersten Beantragung erhalten Sie ein kostenloses Kontingent, um es kostenlos auszuprobieren; wenn das Kontingent erschöpft ist, können Sie im Dashboard Ihr Guthaben aufladen.

📘 Vollständige Dokumentation: Grok Videos Generation API →

Modellbeschreibung

Diese API wählt den Upstream-Endpunkt anhand des Suffixes des Modellnamens: :reverse verwendet den schnellen/standardmäßigen Endpunkt (günstiger), :official verwendet den offiziellen Endpunkt (höhere Bildqualität, Abrechnung nach Ausgabesekunden). Es werden insgesamt vier Modelle unterstützt:

grok-imagine-video-1.5-fast:reverse (Standard): Unterstützt Text-zu-Video (nur prompt übergeben) und Bild-zu-Video (übergeben Sie image_url), Dauer 6–30 Sekunden, Abrechnung nach Dauer, am günstigsten.
grok-imagine-video:reverse: Unterstützt Text-zu-Video und Bild-zu-Video, Dauer 1–15 Sekunden, Abrechnung nach Ausgabesekunden.
grok-imagine-video:official: Offizieller Endpunkt, unterstützt Text-zu-Video und Bild-zu-Video, Dauer 1–15 Sekunden, Abrechnung nach Ausgabesekunden, höhere Bildqualität.
grok-imagine-video-1.5:official: Offizieller Endpunkt, unterstützt nur Bild-zu-Video, muss image_url übergeben, Dauer 1–15 Sekunden, unterstützt bis zu 1080p, Abrechnung nach Ausgabesekunden.

Grundlegende Nutzung

Zunächst sollten Sie die grundlegende Nutzung verstehen, indem Sie die Eingabeaufforderung prompt, das Modell model und andere Parameter eingeben, um das entsprechende Video zu generieren. Hier haben wir die Request-Header festgelegt, einschließlich:

accept: In welchem Format Sie die Antwort erhalten möchten, hier als application/json, also im JSON-Format.
authorization: Der Schlüssel zum Aufrufen der API, nach der Beantragung können Sie ihn direkt aus der Dropdown-Liste auswählen.

Außerdem haben wir den Request-Body festgelegt, einschließlich:

prompt: Text-Prompt, der den gewünschten Inhalt des zu generierenden Videos beschreibt. Bei Text-zu-Video erforderlich; optional bei Übergabe von image_url.
model: Das Modell zur Generierung des Videos, wählbar zwischen grok-imagine-video-1.5-fast:reverse (Standard), grok-imagine-video:reverse, grok-imagine-video:official oder grok-imagine-video-1.5:official.
image_url: Eingabebildlink für Bild-zu-Video. Bei model als grok-imagine-video-1.5:official erforderlich.
reference_image_urls: Array von optionalen Referenzbildlinks, um den Stil oder Inhalt des Videos zu leiten.
aspect_ratio: Das Seitenverhältnis des zu generierenden Videos, wählbar zwischen 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3.
resolution: Ausgaberesolution, wählbar zwischen 480p (Standard), 720p oder 1080p.
duration: Dauer des zu generierenden Videos (Sekunden). grok-imagine-video-1.5-fast:reverse hat einen Wertebereich von 6–30, die anderen Modelle von 1–15, Standard ist 6. Es wird empfohlen, 6 Sekunden oder 10 Sekunden zu verwenden, diese beiden Standarddauern sind relativ stabil.
callback_url: Asynchrone Rückrufadresse, nach der Einstellung gibt die API sofort task_id zurück, und bei Abschluss der Aufgabe wird das Ergebnis an diese Adresse POST gesendet.
async: Optional, wenn auf true gesetzt, gibt die Schnittstelle sofort task_id zurück, ohne dass callback_url bereitgestellt werden muss, und anschließend kann das Ergebnis über die entsprechende Aufgabenabfrage-Schnittstelle abgefragt werden.

Klicken Sie auf die Schaltfläche „Try“, um einen Test durchzuführen, das Ergebnis sieht ähnlich aus wie folgt:

{
  "success": true,
  "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "trace_id": "fb751e1e-4705-49ea-9fd4-5024b7865ea2",
  "data": [
    {
      "id": "grok-imagine-video-1.5-fast:reverse:41eb9a5f-3b2d-4d1e-9f5a-6c2f1a0b9e77",
      "video_url": "https://cdn.acedata.cloud/c8cbf53aa0.mp4",
      "state": "succeeded"
    }
  ]
}

Die Rückgabe hat mehrere Felder, die wie folgt beschrieben werden:

success: Ob die Videoerstellungsanfrage erfolgreich war.
task_id: Die ID der Videoerstellungsaufgabe.
trace_id: Die Verfolgungs-ID dieser Anfrage, um Probleme zu identifizieren.
data: Liste der generierten Videoergebnisse.
- id: Eindeutige Kennung des generierten Videos.
- video_url: Linkadresse des generierten Videos.
- state: Status der Videoerstellungsaufgabe, wählbar zwischen pending / succeeded / failed.

Wir müssen nur die video_url aus dem data-Ergebnis abrufen, um das generierte Video zu erhalten. Der entsprechende CURL-Code sieht wie folgt aus:

curl -X POST 'https://api.acedata.cloud/grok/videos' \
-H 'authorization: Bearer ${bearer_token}' \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-d '{
  "prompt": "A cinematic shot of a kitten chasing a butterfly in a sunlit garden",
  "model": "grok-imagine-video-1.5-fast:reverse",
  "resolution": "480p",
  "duration": 6
}'

Der entsprechende Python-Code sieht wie folgt aus:

import requests

url = "https://api.acedata.cloud/grok/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "prompt": "A cinematic shot of a kitten chasing a butterfly in a sunlit garden",
    "model": "grok-imagine-video-1.5-fast:reverse",
    "resolution": "480p",
    "duration": 6
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Bild-zu-Video

Wenn Sie ein Video basierend auf einem Eingabebild generieren möchten, können Sie image_url übergeben. Bei Verwendung von grok-imagine-video-1.5:official muss dieses Feld bereitgestellt werden:

{
  "prompt": "The character slowly turns around and smiles at the camera",
  "model": "grok-imagine-video-1.5:official",
  "image_url": "https://cdn.acedata.cloud/5hmkdg.jpg",
  "resolution": "720p",
  "duration": 6
}

Referenzbilder zur Anleitung

Wenn Sie ein oder mehrere Referenzbilder verwenden möchten, um den Stil oder Inhalt des Videos zu leiten, können Sie ein Array von Bildlinks in reference_image_urls übergeben:

{
  "prompt": "A character dancing in the same art style",
  "model": "grok-imagine-video-1.5-fast:reverse",
  "reference_image_urls": [
    "https://cdn.acedata.cloud/vunnjf.png"
  ]
}

Asynchrone Rückrufe

Die Videoerstellung benötigt eine gewisse Verarbeitungszeit. Wenn Sie nicht lange warten möchten, können Sie callback_url übergeben. In diesem Fall gibt die API sofort task_id zurück, und nach Abschluss der Aufgabe wird das Endergebnis an diese Adresse POST gesendet:

{
  "prompt": "Eine filmische Aufnahme eines Kätzchens, das einem Schmetterling in einem sonnenbeschienenen Garten nachjagt",
  "model": "grok-imagine-video-1.5-fast:reverse",
  "duration": 6,
  "callback_url": "https://your-domain.com/callback/grok"
}

Das sofort zurückgegebene Ergebnis sieht wie folgt aus:

{
  "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea"
}

Abfrage des Aufgabenergebnisses

Wenn Sie asynchrone Rückrufe verwendet haben oder den Status der Aufgabe aktiv abfragen möchten, können Sie über die Grok Tasks API (POST https://api.acedata.cloud/grok/tasks) den neuesten Status und das Ergebnis der Aufgabe anhand der task_id abfragen.

Abrechnungsinformationen

Die Abrechnungsweise dieses Dienstes wird durch das model bestimmt:

grok-imagine-video-1.5-fast:reverse: Abrechnung nach Dauer, unabhängig von der Auflösung – 6–10 Sekunden, 11–20 Sekunden, 21–30 Sekunden entsprechen jeweils unterschiedlichen Preisstufen.
grok-imagine-video:reverse: Abrechnung nach „Ausgabesekunden“, Gesamtpreis = Einzelpreis × duration.
grok-imagine-video:official und grok-imagine-video-1.5:official: Offizielle Endpunkte, Abrechnung nach „Ausgabesekunden“, je höher die Auflösung, desto höher der Einzelpreis; offizielle Modelle werden auch dann abgerechnet, wenn die Inhaltsprüfung fehlschlägt.

Die genauen Einzelpreise sind auf der Preisseite angegeben. Fehlgeschlagene Anfragen werden nicht abgerechnet und verbrauchen kein kostenloses Kontingent.

Fehlerbehandlung

Wenn bei der Anfrage ein Problem auftritt, gibt die API den entsprechenden Fehlercode und die Beschreibung zurück, häufige sind folgende:

400: Anfrageparameter sind fehlerhaft, z. B. fehlt bei der Videoerstellung prompt, oder grok-imagine-video-1.5:official fehlt image_url, oder duration liegt außerhalb des zulässigen Bereichs (für grok-imagine-video-1.5-fast:reverse 6–30, für andere Modelle 1–15).
401: Authentifizierung fehlgeschlagen, Token ungültig oder stimmt nicht mit der API überein.
403: Unzureichendes Guthaben oder der Hinweis wurde aufgrund der Inhaltsprüfung abgelehnt.
429: Anfragen sind zu häufig, bitte später erneut versuchen.
500: Videoerstellung fehlgeschlagen oder Dienstfehler.

Erste Schritte

KI Chat

KI Bild

KI Video

KI Audio

Web & Daten

CAPTCHA

Identität

Coding

Weitere Anleitungen

Grok Videos Generation API Integrationsanleitung

Antragsprozess

Modellbeschreibung

Grundlegende Nutzung

Bild-zu-Video

Referenzbilder zur Anleitung

Asynchrone Rückrufe

Abfrage des Aufgabenergebnisses

Abrechnungsinformationen

Fehlerbehandlung

​Antragsprozess

​Modellbeschreibung

​Grundlegende Nutzung

​Bild-zu-Video

​Referenzbilder zur Anleitung

​Asynchrone Rückrufe

​Abfrage des Aufgabenergebnisses

​Abrechnungsinformationen

​Fehlerbehandlung

Antragsprozess

Modellbeschreibung

Grundlegende Nutzung

Bild-zu-Video

Referenzbilder zur Anleitung

Asynchrone Rückrufe

Abfrage des Aufgabenergebnisses

Abrechnungsinformationen

Fehlerbehandlung