grok-imagine-video
Grok Imagine Video erstellt kurze Videos anhand von Textbeschreibungen mit auswählbarer Dauer und Bildform. Das xAI-Modell selbst unterstützt auch Bildanimation und gezielte Videobearbeitung.
Ü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 Video
Grok Imagine Video erstellt Videos aus Text. Das xAI-Modell selbst hat auch Modi mit Ausgangsbildern und -videos. Bei der veröffentlichten Ailoot-Generierungsmethode dient eine Textbeschreibung als Eingabe; das Ergebnis ist ein Video.
Generierung erfolgt asynchron: Zunächst wird eine Aufgabe erstellt, danach werden Status und fertiges Ergebnis über ihren Bezeichner abgerufen. Laut xAI kann die Videoerstellung mehrere Minuten dauern; die Zeit hängt von Szenenkomplexität, Dauer, Auflösung und gewähltem Modus ab.
Dauer und Bildform
Zur Videoerstellung ist eine Dauer von 1 bis 15 Sekunden verfügbar. Die Bildformate umfassen 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 und 2:3; Standard ist 16:9. Diese Version sieht 480p und 720p vor; 1080p gehört zur Version 1.5.
Animation eines Ausgangsbildes
Im xAI-Bildmodus wird das Bild zum Anfangsbild; die Textanweisung legt die Bewegung fest. Standardmässig übernimmt die Videoform die Proportionen des Ausgangsbildes. Ein ausdrücklich vorgegebenes Seitenverhältnis verändert diese Form und kann das Bild strecken.
Gezielte Bearbeitung
Bei fertigen Videos wendet das Modell beschriebene Änderungen an und erhält den übrigen Szeneninhalt. Dieser Modus hilft, ein gewünschtes Element zu ändern und die Inszenierung des Ausgangsvideos zu bewahren. Dauer und Proportionen werden vom Original übernommen; neue Dauer oder Bildform werden nicht vorgegeben.
Das Ausgangsvideo zur Bearbeitung ist auf 8,7 Sekunden begrenzt; die Ergebnisauflösung auf höchstens 720p. Material in 1080p wird auf 720p reduziert. Einstellungen der Textgenerierung werden nicht automatisch auf Bearbeitung übertragen.
Fortsetzung eines fertigen Videos
In einem separaten xAI-Modus setzt diese Version ein Ausgangsvideo ab dessen letztem Bild fort. Die ursprüngliche MP4-Datei muss 2 bis 15 Sekunden dauern; der ergänzte Teil 2 bis 10 Sekunden, standardmässig 6. Das Ergebnis verbindet Ausgangsvideo und Fortsetzung. Proportionen und Auflösung werden vom Ausgangsmaterial übernommen, mit einer Grenze von 720p; sie lassen sich in diesem Modus nicht separat verändern. Diese Herstellerfähigkeit unterscheidet sich von der veröffentlichten Ailoot-Textgenerierung.
Referenzen und Versionsgrenzen
xAI sieht visuelle Referenzen vor, um das Aussehen von Menschen, Kleidung und Gegenständen in der Szene zu steuern. Eine Referenz legt visuelle Merkmale fest und nicht das genaue Anfangsbild. Bei der klassischen Grok Imagine Video lassen sich Anfangsbild und Referenzen nicht verbinden.
Diese Version akzeptiert kein genau festgelegtes Endbild und keine Zwischen-Keyframes. Diese Fähigkeiten gehören zu Grok Imagine Video 1.5. Generierung, Animation eines Ausgangsbildes und Änderung eines fertigen Videos sind unterschiedliche Modi; die veröffentlichte Ailoot-Methode beschreibt hier Textgenerierung.
Ailoot · Videoerzeugung POST /v1/videos/generations grok-imagine-video
grok-imagine-videoEinstieg
Grok Imagine Video erstellt kurze Videos anhand von Textbeschreibungen mit auswählbarer Dauer und Bildform. 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 · Videoerzeugung POST /v1/videos/generations
- Eingabe
text- Ausgabe
video- Ausgabeformat
- mp4
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits grok-imagine-video | Standard— |
Feldprompt | Typstring | AnforderungOptional | Werte und Limits Mindestlänge: 1 | Standard— |
Feldduration | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 15 Bedingungen: Geben Sie duration und seconds nicht gleichzeitig an Einheit: Sekunden | Standard1 |
Feldseconds | Typinteger|integer_string | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 15 Alternative: duration | Standard— |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 480p, 720p | Standard480p |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Bedingungen: Wenn ein Eingabebild vorliegt und das Seitenverhältnis fehlt, übernimmt der Anbieter das Seitenverhältnis des Bildes | Standard16:9 |
Feldsize | Typstring | AnforderungOptional | Werte und Limits 1280x720, 720x1280, 1920x1080, 1080x1920 Bedingungen: Muss mit resolution/aspect_ratio übereinstimmen, wenn beide angegeben sind | Standard— |
Feldimage | Typobject | AnforderungOptional | Werte und Limits Bedingungen: Tatsächliches unterstütztes Eingabebild; erlaubt das Weglassen der Textbeschreibung | Standard— |
Kombinationen von Eingabematerialien
Text zu Video · Erforderlich: prompt
Bild zu Video · Erforderlich: image
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametermaterial_types | Vertragtext |
Parameterrequired | Vertragnull |
Parameteroptional_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
POST /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 abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot · Videoerzeugung
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 · Videoerzeugung
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Auftragsstatus prüfen
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
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.mp4Alle 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 in video.url eine Ihnen zugeordnete Inhalts-URL. Erhalten Sie die gemeldete Dauer und jedes zurückgegebene Ergebnisfeld.
Wenn die ursprüngliche Antwort geprüft werden muss
Lesen Sie den bestehenden ursprünglichen Auftrag; reichen Sie einen Sendevorgang mit unbekanntem Ausgang niemals erneut ein.
Antwortfelder
| Feld | Typ |
|---|---|
Feldrequest_id | Typstring |
Feldid | Typstring |
Feldstatus | Typstring |
Feldvideo.url | Typowned signed content URL |
Feldvideo.duration | Typnumber |
Feldvideo.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 | BedingungDer ursprüngliche Ergebnisinhalt ist noch nicht verfügbar | Nächster SchrittFragen Sie die ursprünglich zurückgegebene ID ab und beachten Sie Retry-After. |
Antwortserver_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
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