grok-imagine-video
Grok Imagine Video erstellt kurze Videos anhand von Textbeschreibungen mit wählbarer Dauer und Bildform. Das Modell von xAI 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 Modell von xAI selbst hat außerdem Modi mit einem Ausgangsbild oder -video. In der veröffentlichten Generierungsmethode von Ailoot dient eine Textbeschreibung als Eingabe; das Ergebnis ist ein Video.
Die Generierung erfolgt asynchron: Zunächst wird ein Auftrag erstellt, anschließend werden über dessen Kennung der Status und das fertige Ergebnis abgerufen. Laut xAI kann die Erstellung eines Videos mehrere Minuten dauern; die Zeit hängt von Szenenkomplexität, Dauer, Auflösung und gewähltem Modus ab.
Dauer und Bildformat
Für die 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; das Standardformat ist 16:9. Bei dieser Version sind 480p und 720p vorgesehen; 1080p gehört zur Version 1.5.
Animation eines Ausgangsbilds
Im Bildmodus von xAI wird das Bild zum ersten Frame, und die Textanweisung legt die Bewegung fest. Standardmäßig übernimmt das Video die Proportionen des Ausgangsbilds. Ein ausdrücklich vorgegebenes Seitenverhältnis ändert diese Form und kann das Bild verzerren.
Gezielte Bearbeitung
Bei der Arbeit mit einem fertigen Video setzt das Modell die beschriebenen Änderungen um und erhält den übrigen Szeneninhalt. Dieser Modus hilft, das gewünschte Element zu verändern und die Inszenierung des Ausgangsvideos beizubehalten. Dauer und Proportionen werden vom Original übernommen; eine neue Dauer oder Bildform wird nicht festgelegt.
Das Ausgangsvideo für die Bearbeitung ist auf 8,7 Sekunden begrenzt; das Ergebnis auf eine Auflösung von höchstens 720p. Material in 1080p wird auf 720p reduziert. Einstellungen der Generierung aus Text gelten nicht automatisch für die Bearbeitung.
Fortsetzung eines fertigen Videos
In einem separaten Modus von xAI setzt diese Version ein Ausgangsvideo ab seinem letzten Frame fort. Die Ausgangsdatei in MP4 muss 2 bis 15 Sekunden dauern; der hinzugefügte Teil 2 bis 10 Sekunden, standardmäßig 6. Das Ergebnis verbindet das Ausgangsvideo mit der Fortsetzung. Proportionen und Auflösung werden vom Ausgangsmaterial übernommen, mit einer Grenze von 720p; sie können in diesem Modus nicht separat geändert werden. Diese Funktion des Herstellers unterscheidet sich von der veröffentlichten Generierung aus Text in Ailoot.
Referenzen und Grenzen der Version
xAI sieht die Verwendung visueller Referenzen vor, um das Aussehen von Menschen, Kleidung und Gegenständen in einer Szene zu steuern. Eine Referenz legt visuelle Merkmale fest und kein exaktes Bild des ersten Frames. Beim klassischen Grok Imagine Video kann ein Startframe nicht mit Referenzen kombiniert werden.
Diese Version nimmt keine genaue Festlegung des letzten Frames und keine Zwischen-Keyframes an. Diese Funktionen gehören zu Grok Imagine Video 1.5. Generierung, Animation eines Ausgangsbilds und Änderung eines fertigen Videos sind unterschiedliche Modi; die veröffentlichte Ailoot-Methode beschreibt hier die Generierung aus Text.
Ailoot · Videos POST /v1/videos/generations grok-imagine-video
grok-imagine-videoEinstieg
Grok Imagine Video erstellt kurze Videos anhand von Textbeschreibungen mit wählbarer Dauer und Bildform. Das Modell von xAI selbst unterstützt auch Bildanimation und gezielte Videobearbeitung.
- Zulässige Eingaben
- Text
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot · Videos 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 angegeben und das Seitenverhältnis weggelassen wird, übernimmt der Anbieter das Seitenverhältnis des Bildes | Standard16:9 |
Feldsize | Typstring | AnforderungOptional | Werte und Limits 1280x720, 720x1280, 1920x1080, 1080x1920 Bedingungen: Muss zu resolution/aspect_ratio passen, wenn beide angegeben sind | Standard— |
Feldimage | Typobject | 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 |
|---|---|
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 abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot · Videos
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 · Videos
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 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; übermitteln Sie eine Anfrage mit unbekanntem Übermittlungsergebnis niemals erneut.
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 regelmäßig 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