Grok Imagine Video 1.5

Grok Imagine Video 1.5 ist das Videomodell von xAI. Eine Anfrage erzeugt einen 6–15 Sekunden langen Clip mit Ton aus einem Prompt oder aus einem Prompt plus einem Bild, in 480p oder 720p und in 16:9, 9:16 oder 1:1. Sende die Anfrage, behalte die zurückgegebene Aufgaben-ID und lies das fertige Video aus der Aufgabe. Bilder werden als URLs übergeben.

Modell-IDs

Aktuelle Preise findest du auf der Modellseite.

Kurzbeispiel

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1-5",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in, birdsong. No text, no logos.",
    "resolution": "480p",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

Endpunkt

POST https://api.seedrouter.ai/v1/videos/generations

Die Antwort ist eine Aufgabe ({"id": "task_...", "status": "processing"}), nicht das fertige Video. Frag GET /v1/tasks/{task_id} ab, um das Ergebnis zu erhalten. Bewahre API-Schlüssel im serverseitigen Code auf.

Parameter

Das Schema ist strikt: Unbekannte Felder werden abgelehnt statt ignoriert. callback_url ist nicht verfügbar; frag stattdessen die Aufgabe ab.

Bild zu Video

Übergib ein Bild in image_urls und beschreibe in prompt, was als Nächstes passiert. Der Clip beginnt mit dem Bild und übernimmt sein Format. Ein Bild im Hochformat ergibt also einen Clip im Hochformat, unabhängig vom Wert von aspect_ratio.

{
  "model": "grok-imagine-video-1-5",
  "prompt": "The subject slowly turns toward the camera, soft natural light, gentle breeze, quiet room tone.",
  "image_urls": ["https://example.com/start.png"],
  "resolution": "720p",
  "duration": 6
}

Medieneingaben

Das Bild ist eine öffentliche HTTP(S)-URL. Base64-Data-URIs werden nicht akzeptiert: Lade die Datei in deinen eigenen Speicher hoch und übergib ihre URL. Verwende ein JPG- oder PNG-Bild mit höchstens 10 MB.

Kostenfaktoren

Aktuelle Tarife findest du im Preisbereich der Modellseite. Grok Imagine Video 1.5 wird pro Sekunde Video abgerechnet, zu einem Tarif, den die Auflösung bestimmt:

cost = duration × rate per second for the resolution

Text zu Video und Bild zu Video kosten gleich viel. Die Dauer steht fest, wenn die Anfrage angenommen wird, daher ist der reservierte Betrag auch der berechnete Betrag. Die endgültigen Kosten siehst du im Nutzungsverlauf deines Kontos. Fehlgeschlagene Aufgaben werden nicht berechnet.

Ausgabeschema

Beim Senden wird die Aufgabe zurückgegeben:

{"id": "task_...", "model": "grok-imagine-video-1-5", "status": "processing", "created_at": 1789689600}

Aufgabe abrufen

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Frag alle 10–20 Sekunden ab, bis status den Wert completed oder failed hat. Eine Zeitüberschreitung des Netzwerks während der Abfrage bedeutet nicht, dass die Erzeugung fehlgeschlagen ist: Behalte die Aufgaben-ID und setze die Prüfung fort. Erstelle keine weitere Aufgabe, um den Fortschritt zu prüfen.

Abgeschlossene Aufgabe

{
  "id": "task_...",
  "model": "grok-imagine-video-1-5",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689720,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

In unseren Tests kamen 8-Sekunden-Clips in 720p als MP4 (H.264) mit einer AAC-Audiospur zurück, in 1280 × 720 für 16:9, 720 × 1280 für 9:16 und 720 × 720 für 1:1, 111–133 Sekunden nach dem Absenden. 480p-Clips kamen nach 45–84 Sekunden zurück.

Fehler

Anfragen, die vor der Erstellung einer Aufgabe abgelehnt werden, geben einen HTTP-Fehler mit einem error-Objekt zurück und werden nicht berechnet. Eine Aufgabe, die nach der Annahme fehlschlägt, gibt bei der Abfrage HTTP 200 zurück, zusammen mit status: "failed" und einem error-Objekt.

Codes, HTTP-Status und Hinweise zu Wiederholungen findest du im gemeinsamen Fehlerkatalog.

{
  "id": "task_...",
  "model": "grok-imagine-video-1-5",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Kommt es beim Senden selbst zu einer Zeitüberschreitung, prüfe deine Aufgaben, bevor du erneut sendest: Die erste Anfrage wurde möglicherweise bereits angenommen.

Tipps

• Beschreibe Motiv, Ort, Kamerabewegung und Licht und nenne die gewünschten Geräusche; der Ton wird zusammen mit dem Bild erzeugt.
• Erstelle Entwürfe in 480p und rendere die finale Einstellung dann mit derselben Anfrage in 720p.
• Sende für Videos im Hochformat aspect_ratio: "9:16" oder ein Bild im Hochformat.
• Füge no text, no logos hinzu, um erfundene Zeichen fernzuhalten.

Weiterführend

• Playground und Preise für Grok Imagine Video 1.5
• API-Referenz für Kling 3.0 Turbo
• OpenAPI herunterladen
• Markdown zum Kopieren