grok-imagine-video

Grok Imagine Video erstellt kurze Clips aus Textbeschreibungen mit wählbarer Dauer und wählbarem Bildformat. Das xAI-Modell selbst unterstützt auch Bildanimation und gezielte Videobearbeitung.

Ailoot · Videogenerierung POST /v1/videos/generations grok-imagine-video

Über das Modell

Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.

Von der Beschreibung zum Clip

Grok Imagine Video erstellt Videos aus Text. Das xAI-Modell selbst bietet auch Modi mit Ausgangsbildern und Videos. Die veröffentlichte Ailoot-Generierungsmethode verwendet eine Textbeschreibung als Eingabe und liefert einen Clip als Ergebnis.

Die Generierung erfolgt asynchron: Zunächst wird eine Aufgabe erstellt, anschließend werden ihr Zustand und das fertige Ergebnis anhand ihres Identifikators abgerufen. Laut xAI kann die Cliperstellung mehrere Minuten dauern; die Zeit hängt von Szenenkomplexität, Dauer, Auflösung und gewähltem Modus ab.

Dauer und Bildformat

Für die Cliperstellung sind 1 bis 15 Sekunden verfügbar. Die Bildformate umfassen 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 und 2:3; das Standardformat ist 16:9. Für diese Version sind 480p und 720p vorgesehen; 1080p gehört zu Version 1.5.

Ein Ausgangsbild animieren

Im xAI-Bildmodus wird das Bild zum ersten Bild des Videos; eine Textanweisung legt die Bewegung fest. Standardmäßig folgt die Clipform dem Seitenverhältnis des Ausgangsbildes. Ein ausdrücklich vorgegebenes Seitenverhältnis verändert diese Form und kann das Bild strecken.

Gezielte Bearbeitung

Bei einem vorhandenen Video wendet das Modell beschriebene Änderungen an und erhält den übrigen Szeneninhalt. Dieser Modus hilft, ein gewünschtes Element zu ändern und dabei die ursprüngliche Inszenierung zu bewahren. Dauer und Seitenverhältnis werden vom Original übernommen; eine neue Dauer oder Bildform wird nicht vorgegeben.

Das Ausgangsvideo zur Bearbeitung ist auf 8,7 Sekunden, das Ergebnis auf höchstens 720p begrenzt. 1080p-Material wird auf 720p verkleinert. Einstellungen der Videogenerierung aus Text werden nicht automatisch auf Bearbeitung übertragen.

Einen vorhandenen Clip fortsetzen

In einem separaten xAI-Modus setzt diese Version einen Ausgangsclip ab dessen letztem Bild fort. Die Ausgangs-MP4 muss 2 bis 15 Sekunden dauern; der hinzugefügte Teil 2 bis 10 Sekunden, standardmäßig 6. Das Ergebnis verbindet Ausgangsvideo und Fortsetzung. Seitenverhältnis und Auflösung werden vom Ausgangsmaterial übernommen, mit einem Limit von 720p; sie lassen sich in diesem Modus nicht separat ändern. Diese Herstellerfähigkeit unterscheidet sich von veröffentlichter Ailoot-Generierung aus Text.

Referenzen und Versionsgrenzen

xAI sieht visuelle Referenzen zur Steuerung des Aussehens von Menschen, Kleidung und Gegenständen in einer Szene vor. Eine Referenz legt visuelle Merkmale fest, nicht das genaue erste Bild. Bei klassischem Grok Imagine Video können Ausgangsbild und Referenzen nicht verbunden werden.

Diese Version akzeptiert keine genaue Fixierung des letzten Bildes oder zwischenliegende Keyframes. Diese Fähigkeiten gehören zu Grok Imagine Video 1.5. Generierung, Animation eines Ausgangsbildes und Änderung vorhandener Clips sind unterschiedliche Modi; die veröffentlichte Ailoot-Methode beschreibt hier Generierung aus Text.

Ailoot · Videogenerierung POST /v1/videos/generations grok-imagine-video

grok-imagine-video

xAI /grok-imagine-video

Start

Grok Imagine Video erstellt kurze Clips aus Textbeschreibungen mit wählbarer Dauer und wählbarem Bildformat. Das xAI-Modell selbst unterstützt auch Bildanimation und gezielte Videobearbeitung.

Zulässige Eingaben: Text
Ergebnisse: Video

In Ailoot verfügbar · Eingaben und Methoden

Ailoot · Videogenerierung POST /v1/videos/generations

Eingabetypen: text
Ausgabetypen: video
Ausgabeformat: mp4

Feld	Typ	Anforderung	Werte und Limits	Standard
Feld`model`	Typ`string`	AnforderungErforderlich	Werte und Limits grok-imagine-video	Standard—
Feld`prompt`	Typ`string`	AnforderungOptional	Werte und Limits Mindestlänge: 1	Standard—
Feld`duration`	Typ`integer`	AnforderungOptional	Werte und Limits Minimum: 1 Maximum: 15 Bedingungen: Nicht gleichzeitig duration und seconds angeben Einheit: Sekunden	Standard1
Feld`seconds`	Typ`integer\|integer_string`	AnforderungOptional	Werte und Limits Minimum: 1 Maximum: 15 Alternative: duration	Standard—
Feld`resolution`	Typ`string`	AnforderungOptional	Werte und Limits 480p, 720p	Standard480p
Feld`aspect_ratio`	Typ`string`	AnforderungOptional	Werte und Limits 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Bedingungen: Bei bereitgestelltem Eingabebild und weggelassenem Seitenverhältnis übernimmt der Anbieter das Seitenverhältnis des Bilds	Standard16:9
Feld`size`	Typ`string`	AnforderungOptional	Werte und Limits 1280x720, 720x1280, 1920x1080, 1080x1920 Bedingungen: Muss mit resolution/aspect_ratio übereinstimmen, wenn beide angegeben sind	Standard—
Feld`image`	Typ`object`	AnforderungOptional	Werte und Limits Bedingungen: Tatsächliches unterstütztes Eingabebild; erlaubt das Weglassen des Prompts	Standard—

Kombinationen von Eingabematerialien

Text zu Video · Erforderlich: prompt

Bild zu Video · Erforderlich: image

Methodenparameter und Lebenszyklus

Parameter	Vertrag
Parameter`material_types`	Vertragtext
Parameter`required`	Vertragnull
Parameter`optional_controls`	Vertragnull

Lebenszyklus: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

Methodenstrukturen und IDs sind exakt; die Fähigkeiten des Anbieters sind von der Zulassung einer Anfrage zu unterscheiden.

Tarife

Ailoot-Methodentarife

Ailoot VideogenerierungPOST /v1/videos/generations

Eingabe: 0,002 $ pro Eingabebild
Eingabe: 0,01 $ pro Sekunde Eingabevideo
Ausgabe: 0,05 $ pro Sekunde bei 480p
Ausgabe: 0,07 $ pro Sekunde bei 720p

Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →

Beispielanfragen

Ailoot · Videogenerierung

Videobeispiel

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-imagine-video", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'

Ergebnisse abrufen und speichern

Ailoot · Videogenerierung

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Auftragsstatus prüfen

GET · Status

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY"

Abrufe anderer Inhalte

GET · Inhalt

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  --output video.mp4

Alle fertiggestellten Ergebnisse aufbewahren

Speichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.

Bewahren Sie das vollständige Status-JSON und die tatsächliche request_id auf. Eine abgeschlossene Antwort mit status=done enthält video.url mit einer Ihnen zugeordneten Inhalts-URL. Bewahren Sie die gemeldete Dauer und jedes zurückgegebene Ergebnisfeld auf.

Wenn die ursprüngliche Antwort geprüft werden muss

Lesen Sie den vorhandenen ursprünglichen Auftrag aus; wiederholen Sie eine Übermittlung mit unklarem Ausgang niemals.

Antwortfelder

Feld	Typ
Feld`request_id`	Typstring
Feld`id`	Typstring
Feld`status`	Typstring
Feld`video.url`	Typowned signed content URL
Feld`video.duration`	Typnumber
Feld`video.respect_moderation`	Typboolean

Fehler und nächste Schritte

Antwort	Bedingung	Nächster Schritt
Antwort400 · `invalid_request_error`	BedingungPflichtfelder, Darstellung des Eingabematerials oder Parameterwert ungültig	Nächster SchrittDie angegebenen Felder vor einer neuen Erstellungsanfrage korrigieren.
Antwort409 · `video_not_ready`	BedingungUrsprünglicher Ergebnisinhalt noch nicht verfügbar	Nächster SchrittFragen Sie die ursprünglich zurückgegebene ID regelmäßig ab und beachten Sie Retry-After.
Antwort`server_error`	BedingungDie zurückgegebene Antwort gibt an, dass der Vorgang oder das Ergebnis eine Prüfung erfordert	Nächster SchrittDie ursprünglich zurückgegebene Vorgangs-/Aufgaben-ID, die Anfrageheader und die Antwort aufbewahren; mit unterstützten Leseaufrufen für diesen ursprünglichen Vorgang fortfahren. Die Erstellungsanfrage nicht erneut senden.

Aliasnamen

Modellaliasnamen

Ailoot grok-imagine-video

Aliasnamen für Methodenpfade

Verwenden Sie die oben angezeigten Methodenpfade.

Zugehörige Aufrufer-IDs

grok-imagine-video

FAQ · grok-imagine-video

Welche Eingaben und Ergebnisse sind verfügbar?: POST /v1/videos/generations · grok-imagine-video: text → video
Welche Felder verwendet die Anfrage?: POST /v1/videos/generations · grok-imagine-video: model, prompt, duration, seconds, resolution, aspect_ratio, size, image
Welche Grenzen gelten?: POST /v1/videos/generations · grok-imagine-video: duration.minimum: 1; duration.maximum: 15; seconds.minimum: 1; seconds.maximum: 15

grok-imagine-video