> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok Videos Generation API Integrationsanleitung

> Grok API guide - Ace Data Cloud

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](https://platform.acedata.cloud/console/applications) abrufen und für zukünftige Verwendung aufbewahren.

![](https://cdn.acedata.cloud/dvc3cg.jpg)

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](https://platform.acedata.cloud/console/coin) Ihr Guthaben aufladen.

> 📘 Vollständige Dokumentation: [Grok Videos Generation API →](https://platform.acedata.cloud/documents/grok-videos)

## 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:

```json theme={null}
{
  "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:

```shell theme={null}
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:

```python theme={null}
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:

```json theme={null}
{
  "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:

```json theme={null}
{
  "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:

```json theme={null}
{
  "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:

```json theme={null}
{
  "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](https://platform.acedata.cloud/documents/grok-tasks) (`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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.