{ "aboutHtml": "

Grok Imagine Video ist die klassische Modellversion der Grok-Imagine-Videofamilie. Die aktuelle Herstellerdokumentation behandelt die Erzeugung eines neuen Clips aus einem Prompt, die Animation eines Anfangsbildes, die Verwendung visueller Referenzen sowie Änderung oder Fortsetzung eines vorhandenen Videos. Diese Workflows erzeugen unterschiedliche Ergebnisse: eine neue Szene, eine bearbeitete Fassung bereitgestellten Materials oder ein Video mit ursprünglichem Material und anschließenden neuen Inhalten. Wählen Sie den Workflow anhand des bereits vorhandenen Materials und des zu ändernden Teils der Einstellung.

Beschreiben Sie für eine neue Text-zu-Video-Einstellung Motiv, Umgebung, sichtbare Handlung, Kamera und Ton. Standardgenerierung unterstützt Clips von 1–15 Sekunden mit 480p- oder 720p-Ausgabe und erzeugtem Audio. Quadratische, querformatige, hochformatige und breitere Seitenverhältnisse sind dokumentiert, darunter 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 und 5:2. Ein eigenes Briefing könnte eine Papierlaterne verlangen, die sich sanft über einem ruhigen Innenhof bewegt, während die Kamera seitlich fährt. Die nützliche Prüfung bewertet, ob Bewegung, Bildausschnitt und Umgebungston diese eine Einstellung unterstützen.

Bei Bild-zu-Video ist das bereitgestellte Standbild das erste Videobild. Bereiten Sie es mit vorgesehenem Beschnitt, Motiv und sichtbaren Details vor und beschreiben Sie anschließend die folgende Handlung. Die Ausgabe folgt dem Seitenverhältnis des Bildes. Ein Anfangsstandbild liefert eine genaue Eröffnungskomposition; Referenz-zu-Video verwendet dagegen Bilder zur Steuerung von Personen, Produkten oder Umgebung in einer neu komponierten Szene. Diese beiden Rollen auseinanderzuhalten hilft, einen unbeabsichtigten Anfang zu vermeiden, wenn ein bekanntes Objekt in einer anderen Umgebung erscheinen soll.

Das klassische Modell akzeptiert bis zu sieben Referenzbilder pro referenzgestützter Anfrage. Dieser Modus ist auf zehn Sekunden und 720p begrenzt. Geben Sie jeder Referenz eine klare Rolle und identifizieren Sie sie anhand ihrer Listenposition, beginnend mit <IMAGE_0>. Für eine kurze Produktszene kann eine Referenz das Objekt und eine andere den gewünschten Ort bestimmen. Konzentrieren Sie das Briefing auf die Objektplatzierung und die Haupthandlung der Einstellung. Der klassische Referenzmodus verwendet eine eigene Konfiguration; die vollständige 1.5-Version liefert zusätzliche Steuerung für ausgewählte Stimmen und festgelegte Bilder.

Videobearbeitung nimmt einen vorhandenen Clip und einen Prompt zur gewünschten Änderung entgegen. Der Hersteller akzeptiert MP4-Quellen mit unterstützten Codecs wie H.264, H.265 oder AV1 und bis zu 8,7 Sekunden Länge. Das bearbeitete Ergebnis bewahrt Quelldauer und Seitenverhältnis und folgt der Quellauflösung bis zu einer Obergrenze von 720p. Benutzerdefinierte Steuerung für Dauer, Seitenverhältnis und Auflösung gilt für diesen Bearbeitungsworkflow nicht. Bereiten Sie eine Quelle vor, die die für die endgültige Nutzung benötigte Komposition und Zeitgestaltung bereits enthält, damit der Prompt sich auf die vorgesehene visuelle Änderung konzentrieren kann.

Ein eigenes Bearbeitungsbriefing könnte die Farbe eines Schals ändern und dabei Gesicht, Bewegung, Hintergrund und Kamera der Person bewahren. Benennen Sie diese erhaltenen Elemente ausdrücklich neben der Änderung. Der Hersteller beschreibt das möglichst genaue Bewahren der übrigen Quelle; dies ist ein nützliches Prüfziel, keine Garantie identischer Pixel. Vergleichen Sie das Ergebnis über den gesamten Clip, besonders wenn das Objekt sich bewegt, ein anderes Objekt kreuzt oder teilweise verdeckt wird. Das fertige Ergebnis ist der bearbeitete Clip, nicht lediglich ein Standbild mit der neuen Farbe.

Videoerweiterung setzt am letzten Bild eines vorhandenen MP4 an. Die dokumentierte Quelllänge beträgt 2–15 Sekunden; der ergänzte Teil beträgt 2–10 Sekunden mit sechs Sekunden als Standard. Die Erweiterungsdauer betrifft nur den neuen Teil. Eine zehnsekündige Quelle mit anschließenden fünf Sekunden Fortsetzung erzeugt ein fünfzehnsekündiges Video mit beiden Teilen. Das Ergebnis bewahrt Quellseitenverhältnis und Auflösung innerhalb einer Obergrenze von 720p. Bereiten Sie den letzten Moment der Quelle vor und beschreiben Sie das folgende Geschehen, etwa das Motiv, das sich einem näher kommenden Objekt zuwendet, während die Kamera ihre aktuelle Bewegung fortsetzt.

Prüfen Sie eine Erweiterung rund um die Grenze zwischen Quelle und neuem Inhalt. Prüfen Sie Motividentität, Bewegungsrichtung, Kameratempo, Licht und Ton, damit die Fortsetzung zur vorangegangenen Handlung passt. Wenn ein Clip an einem visuell ungünstigen Punkt endet, machen Sie diese Grenze zu einem ausdrücklichen Teil der Planung für die nächste Einstellung. Die Zusammenstellung längerer Szenen ist eine Schnittentscheidung: Die Dauergrenzen für Generierung, Referenz, Bearbeitung und Erweiterung sind separat; das Gesamtergebnis einer Erweiterung kann länger als ein gewöhnlicher neu generierter Clip sein.

Der Videoworkflow des Herstellers ist asynchron. Eine Anfragekennung verfolgt eine Aufgabe, bis ein fertiges Ergebnis Videoadresse und Dauer liefert; Ausgabeadressen sind vorübergehend. Bewahren Sie bei der Produktionsschnittvorbereitung das abspielbare Ergebnis und sein Quellmaterial auf. Vollständiges Grok Imagine Video 1.5 bietet native 1080p-Generierung und umfangreichere visuelle, Stimmen- und Bildverankerung; Lite dient einfachen Prompts oder Arbeit mit einem Anfangsbild. Die klassische Modellversion bleibt nützlich, wenn das Ausgangsmaterial bereits ein Video ist, das gezielte Änderung oder Fortsetzung benötigt.

", "aboutText": "Grok Imagine Video ist die klassische Modellversion der Grok-Imagine-Videofamilie. Die aktuelle Herstellerdokumentation behandelt die Erzeugung eines neuen Clips aus einem Prompt, die Animation eines Anfangsbildes, die Verwendung visueller Referenzen sowie Änderung oder Fortsetzung eines vorhandenen Videos. Diese Workflows erzeugen unterschiedliche Ergebnisse: eine neue Szene, eine bearbeitete Fassung bereitgestellten Materials oder ein Video mit ursprünglichem Material und anschließenden neuen Inhalten. Wählen Sie den Workflow anhand des bereits vorhandenen Materials und des zu ändernden Teils der Einstellung.\n\nBeschreiben Sie für eine neue Text-zu-Video-Einstellung Motiv, Umgebung, sichtbare Handlung, Kamera und Ton. Standardgenerierung unterstützt Clips von 1–15 Sekunden mit 480p- oder 720p-Ausgabe und erzeugtem Audio. Quadratische, querformatige, hochformatige und breitere Seitenverhältnisse sind dokumentiert, darunter 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 und 5:2. Ein eigenes Briefing könnte eine Papierlaterne verlangen, die sich sanft über einem ruhigen Innenhof bewegt, während die Kamera seitlich fährt. Die nützliche Prüfung bewertet, ob Bewegung, Bildausschnitt und Umgebungston diese eine Einstellung unterstützen.\n\nBei Bild-zu-Video ist das bereitgestellte Standbild das erste Videobild. Bereiten Sie es mit vorgesehenem Beschnitt, Motiv und sichtbaren Details vor und beschreiben Sie anschließend die folgende Handlung. Die Ausgabe folgt dem Seitenverhältnis des Bildes. Ein Anfangsstandbild liefert eine genaue Eröffnungskomposition; Referenz-zu-Video verwendet dagegen Bilder zur Steuerung von Personen, Produkten oder Umgebung in einer neu komponierten Szene. Diese beiden Rollen auseinanderzuhalten hilft, einen unbeabsichtigten Anfang zu vermeiden, wenn ein bekanntes Objekt in einer anderen Umgebung erscheinen soll.\n\nDas klassische Modell akzeptiert bis zu sieben Referenzbilder pro referenzgestützter Anfrage. Dieser Modus ist auf zehn Sekunden und 720p begrenzt. Geben Sie jeder Referenz eine klare Rolle und identifizieren Sie sie anhand ihrer Listenposition, beginnend mit . Für eine kurze Produktszene kann eine Referenz das Objekt und eine andere den gewünschten Ort bestimmen. Konzentrieren Sie das Briefing auf die Objektplatzierung und die Haupthandlung der Einstellung. Der klassische Referenzmodus verwendet eine eigene Konfiguration; die vollständige 1.5-Version liefert zusätzliche Steuerung für ausgewählte Stimmen und festgelegte Bilder.\n\nVideobearbeitung nimmt einen vorhandenen Clip und einen Prompt zur gewünschten Änderung entgegen. Der Hersteller akzeptiert MP4-Quellen mit unterstützten Codecs wie H.264, H.265 oder AV1 und bis zu 8,7 Sekunden Länge. Das bearbeitete Ergebnis bewahrt Quelldauer und Seitenverhältnis und folgt der Quellauflösung bis zu einer Obergrenze von 720p. Benutzerdefinierte Steuerung für Dauer, Seitenverhältnis und Auflösung gilt für diesen Bearbeitungsworkflow nicht. Bereiten Sie eine Quelle vor, die die für die endgültige Nutzung benötigte Komposition und Zeitgestaltung bereits enthält, damit der Prompt sich auf die vorgesehene visuelle Änderung konzentrieren kann.\n\nEin eigenes Bearbeitungsbriefing könnte die Farbe eines Schals ändern und dabei Gesicht, Bewegung, Hintergrund und Kamera der Person bewahren. Benennen Sie diese erhaltenen Elemente ausdrücklich neben der Änderung. Der Hersteller beschreibt das möglichst genaue Bewahren der übrigen Quelle; dies ist ein nützliches Prüfziel, keine Garantie identischer Pixel. Vergleichen Sie das Ergebnis über den gesamten Clip, besonders wenn das Objekt sich bewegt, ein anderes Objekt kreuzt oder teilweise verdeckt wird. Das fertige Ergebnis ist der bearbeitete Clip, nicht lediglich ein Standbild mit der neuen Farbe.\n\nVideoerweiterung setzt am letzten Bild eines vorhandenen MP4 an. Die dokumentierte Quelllänge beträgt 2–15 Sekunden; der ergänzte Teil beträgt 2–10 Sekunden mit sechs Sekunden als Standard. Die Erweiterungsdauer betrifft nur den neuen Teil. Eine zehnsekündige Quelle mit anschließenden fünf Sekunden Fortsetzung erzeugt ein fünfzehnsekündiges Video mit beiden Teilen. Das Ergebnis bewahrt Quellseitenverhältnis und Auflösung innerhalb einer Obergrenze von 720p. Bereiten Sie den letzten Moment der Quelle vor und beschreiben Sie das folgende Geschehen, etwa das Motiv, das sich einem näher kommenden Objekt zuwendet, während die Kamera ihre aktuelle Bewegung fortsetzt.\n\nPrüfen Sie eine Erweiterung rund um die Grenze zwischen Quelle und neuem Inhalt. Prüfen Sie Motividentität, Bewegungsrichtung, Kameratempo, Licht und Ton, damit die Fortsetzung zur vorangegangenen Handlung passt. Wenn ein Clip an einem visuell ungünstigen Punkt endet, machen Sie diese Grenze zu einem ausdrücklichen Teil der Planung für die nächste Einstellung. Die Zusammenstellung längerer Szenen ist eine Schnittentscheidung: Die Dauergrenzen für Generierung, Referenz, Bearbeitung und Erweiterung sind separat; das Gesamtergebnis einer Erweiterung kann länger als ein gewöhnlicher neu generierter Clip sein.\n\nDer Videoworkflow des Herstellers ist asynchron. Eine Anfragekennung verfolgt eine Aufgabe, bis ein fertiges Ergebnis Videoadresse und Dauer liefert; Ausgabeadressen sind vorübergehend. Bewahren Sie bei der Produktionsschnittvorbereitung das abspielbare Ergebnis und sein Quellmaterial auf. Vollständiges Grok Imagine Video 1.5 bietet native 1080p-Generierung und umfangreichere visuelle, Stimmen- und Bildverankerung; Lite dient einfachen Prompts oder Arbeit mit einem Anfangsbild. Die klassische Modellversion bleibt nützlich, wenn das Ausgangsmaterial bereits ein Video ist, das gezielte Änderung oder Fortsetzung benötigt.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "e3d1f78ebca4b206f56d437876f54cfeadf30688c337ee51bfcb92e905862be7", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de", "methods": [ { "html": "
•

SpaceXAI: Grok Imagine Video

SpaceXAI /x-ai/grok-imagine-video

Start

Grok Imagine Video erzeugt kurze Clips aus Text, einem Anfangsbild oder bis zu sieben visuellen Referenzen. Seine klassische Modellversion bearbeitet außerdem vorhandene MP4-Clips und ergänzt 2–10 Sekunden Fortsetzung. Generierung erreicht 720p mit Audio; Bearbeitung und Erweiterung bewahren den Quellbildausschnitt innerhalb eigener Grenzen.

Zulässige Eingaben
Text · Bilder
Ergebnisse
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.

Grok Imagine Video ist die klassische Modellversion der Grok-Imagine-Videofamilie. Die aktuelle Herstellerdokumentation behandelt die Erzeugung eines neuen Clips aus einem Prompt, die Animation eines Anfangsbildes, die Verwendung visueller Referenzen sowie Änderung oder Fortsetzung eines vorhandenen Videos. Diese Workflows erzeugen unterschiedliche Ergebnisse: eine neue Szene, eine bearbeitete Fassung bereitgestellten Materials oder ein Video mit ursprünglichem Material und anschließenden neuen Inhalten. Wählen Sie den Workflow anhand des bereits vorhandenen Materials und des zu ändernden Teils der Einstellung.

Beschreiben Sie für eine neue Text-zu-Video-Einstellung Motiv, Umgebung, sichtbare Handlung, Kamera und Ton. Standardgenerierung unterstützt Clips von 1–15 Sekunden mit 480p- oder 720p-Ausgabe und erzeugtem Audio. Quadratische, querformatige, hochformatige und breitere Seitenverhältnisse sind dokumentiert, darunter 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 und 5:2. Ein eigenes Briefing könnte eine Papierlaterne verlangen, die sich sanft über einem ruhigen Innenhof bewegt, während die Kamera seitlich fährt. Die nützliche Prüfung bewertet, ob Bewegung, Bildausschnitt und Umgebungston diese eine Einstellung unterstützen.

Bei Bild-zu-Video ist das bereitgestellte Standbild das erste Videobild. Bereiten Sie es mit vorgesehenem Beschnitt, Motiv und sichtbaren Details vor und beschreiben Sie anschließend die folgende Handlung. Die Ausgabe folgt dem Seitenverhältnis des Bildes. Ein Anfangsstandbild liefert eine genaue Eröffnungskomposition; Referenz-zu-Video verwendet dagegen Bilder zur Steuerung von Personen, Produkten oder Umgebung in einer neu komponierten Szene. Diese beiden Rollen auseinanderzuhalten hilft, einen unbeabsichtigten Anfang zu vermeiden, wenn ein bekanntes Objekt in einer anderen Umgebung erscheinen soll.

Das klassische Modell akzeptiert bis zu sieben Referenzbilder pro referenzgestützter Anfrage. Dieser Modus ist auf zehn Sekunden und 720p begrenzt. Geben Sie jeder Referenz eine klare Rolle und identifizieren Sie sie anhand ihrer Listenposition, beginnend mit <IMAGE_0>. Für eine kurze Produktszene kann eine Referenz das Objekt und eine andere den gewünschten Ort bestimmen. Konzentrieren Sie das Briefing auf die Objektplatzierung und die Haupthandlung der Einstellung. Der klassische Referenzmodus verwendet eine eigene Konfiguration; die vollständige 1.5-Version liefert zusätzliche Steuerung für ausgewählte Stimmen und festgelegte Bilder.

Videobearbeitung nimmt einen vorhandenen Clip und einen Prompt zur gewünschten Änderung entgegen. Der Hersteller akzeptiert MP4-Quellen mit unterstützten Codecs wie H.264, H.265 oder AV1 und bis zu 8,7 Sekunden Länge. Das bearbeitete Ergebnis bewahrt Quelldauer und Seitenverhältnis und folgt der Quellauflösung bis zu einer Obergrenze von 720p. Benutzerdefinierte Steuerung für Dauer, Seitenverhältnis und Auflösung gilt für diesen Bearbeitungsworkflow nicht. Bereiten Sie eine Quelle vor, die die für die endgültige Nutzung benötigte Komposition und Zeitgestaltung bereits enthält, damit der Prompt sich auf die vorgesehene visuelle Änderung konzentrieren kann.

Ein eigenes Bearbeitungsbriefing könnte die Farbe eines Schals ändern und dabei Gesicht, Bewegung, Hintergrund und Kamera der Person bewahren. Benennen Sie diese erhaltenen Elemente ausdrücklich neben der Änderung. Der Hersteller beschreibt das möglichst genaue Bewahren der übrigen Quelle; dies ist ein nützliches Prüfziel, keine Garantie identischer Pixel. Vergleichen Sie das Ergebnis über den gesamten Clip, besonders wenn das Objekt sich bewegt, ein anderes Objekt kreuzt oder teilweise verdeckt wird. Das fertige Ergebnis ist der bearbeitete Clip, nicht lediglich ein Standbild mit der neuen Farbe.

Videoerweiterung setzt am letzten Bild eines vorhandenen MP4 an. Die dokumentierte Quelllänge beträgt 2–15 Sekunden; der ergänzte Teil beträgt 2–10 Sekunden mit sechs Sekunden als Standard. Die Erweiterungsdauer betrifft nur den neuen Teil. Eine zehnsekündige Quelle mit anschließenden fünf Sekunden Fortsetzung erzeugt ein fünfzehnsekündiges Video mit beiden Teilen. Das Ergebnis bewahrt Quellseitenverhältnis und Auflösung innerhalb einer Obergrenze von 720p. Bereiten Sie den letzten Moment der Quelle vor und beschreiben Sie das folgende Geschehen, etwa das Motiv, das sich einem näher kommenden Objekt zuwendet, während die Kamera ihre aktuelle Bewegung fortsetzt.

Prüfen Sie eine Erweiterung rund um die Grenze zwischen Quelle und neuem Inhalt. Prüfen Sie Motividentität, Bewegungsrichtung, Kameratempo, Licht und Ton, damit die Fortsetzung zur vorangegangenen Handlung passt. Wenn ein Clip an einem visuell ungünstigen Punkt endet, machen Sie diese Grenze zu einem ausdrücklichen Teil der Planung für die nächste Einstellung. Die Zusammenstellung längerer Szenen ist eine Schnittentscheidung: Die Dauergrenzen für Generierung, Referenz, Bearbeitung und Erweiterung sind separat; das Gesamtergebnis einer Erweiterung kann länger als ein gewöhnlicher neu generierter Clip sein.

Der Videoworkflow des Herstellers ist asynchron. Eine Anfragekennung verfolgt eine Aufgabe, bis ein fertiges Ergebnis Videoadresse und Dauer liefert; Ausgabeadressen sind vorübergehend. Bewahren Sie bei der Produktionsschnittvorbereitung das abspielbare Ergebnis und sein Quellmaterial auf. Vollständiges Grok Imagine Video 1.5 bietet native 1080p-Generierung und umfangreichere visuelle, Stimmen- und Bildverankerung; Lite dient einfachen Prompts oder Arbeit mit einem Anfangsbild. Die klassische Modellversion bleibt nützlich, wenn das Ausgangsmaterial bereits ein Video ist, das gezielte Änderung oder Fortsetzung benötigt.

In Ailoot verfügbar · Eingaben und Methoden

Ailoot Ultra · Video POST /v1/videos
Eingabetypen
text, image
Ausgabetypen
video
Ausgabeformat
Originale MP4-Bytes; keine Normalisierung/Transkodierung
FeldTypAnforderungWerte und LimitsStandard
FeldmodelTypstringAnforderungErforderlichWerte und Limits
x-ai/grok-imagine-video
Standard—
FeldpromptTypstringAnforderungErforderlichWerte und LimitsStandard—
FelddurationTypintegerAnforderungErforderlichWerte und Limits
1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Minimum: 1
Maximum: 600
Standard—
FeldresolutionTypstringAnforderungOptionalWerte und Limits
480p, 720p
Standard—
Feldaspect_ratioTypstringAnforderungOptionalWerte und Limits
16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3
Standard—
Feldgenerate_audioTypbooleanAnforderungOptionalWerte und Limits
false
Standard—
Feldframe_imagesTyparrayAnforderungOptionalWerte und Limits
Mindestanzahl Elemente: 1
Maximale Anzahl Elemente: 1
Eingabeinhalt: Array von Frame-Objekten. Jedes Objekt enthält type=image_url, image_url mit url und frame_type. Verwenden Sie eine HTTPS-Bild-URL und setzen Sie frame_type auf first_frame. Jede Frame-Rolle darf höchstens einmal vorkommen.
Exakte Schlüssel: type, image_url, frame_type
Bedingungen: Diese Schlüssel beschreiben jedes Frame-Objekt; image_url enthält ausschließlich url. Lassen Sie frame_images bei einer reinen Textanfrage weg.
Standard—
Feldinput_referencesTyparrayAnforderungOptionalWerte und LimitsStandard—
FeldsizeTypstringAnforderungOptionalWerte und Limits
854x480, 1280x720, 480x854, 720x1280, 480x480, 720x720, 640x480, 960x720, 480x640, 720x960, 720x480, 1080x720, 480x720, 720x1080
Muster: ^[1-9][0-9]*x[1-9][0-9]*$
Standard—
Feldcallback_urlTypstringAnforderungOptionalWerte und Limits
Muster: ^https://
Standard—
Feldsession_idTypstringAnforderungOptionalWerte und LimitsStandard—
FeldtraceTypobjectAnforderungOptionalWerte und LimitsStandard—
FelduserTypstringAnforderungOptionalWerte und LimitsStandard—
Kombinationen von Eingabematerialien

Text zu Video · Ein schriftlicher Prompt. · Erforderlich: model, prompt, duration

Geben Sie prompt als Text und duration in ganzen Sekunden an. Wählen Sie eine unterstützte Auflösung; ergänzen Sie ein Seitenverhältnis oder verwenden Sie eine aufgeführte Größe.

model: Typ: string · x-ai/grok-imagine-video

prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10.000 · Mindestens ein Zeichen außer Leerraum erforderlich: Ja

Bild zu Video · Ein schriftlicher Prompt und ein Bild für den ersten Frame. · Erforderlich: model, prompt, duration, frame_images

frame_images ist ein Array. Jedes Frame-Objekt enthält type, image_url und frame_type; image_url enthält url. Setzen Sie type auf image_url. Verwenden Sie first_frame. Jede Frame-Rolle darf höchstens einmal vorkommen. Geben Sie für jeden Frame eine öffentliche HTTPS-Bild-URL an. Verwenden Sie in einer Anfrage entweder Frame-Bilder oder Bildreferenzen; kombinieren Sie nicht beides. Wählen Sie eine unterstützte Auflösung; ergänzen Sie ein Seitenverhältnis oder verwenden Sie eine aufgeführte Größe.

Exakte Schlüssel: type, image_url, frame_type

model: Typ: string · x-ai/grok-imagine-video

prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10.000 · Mindestens ein Zeichen außer Leerraum erforderlich: Ja

Reference to video · Ein schriftlicher Prompt und unterstützte Bildreferenzen. · Erforderlich: model, prompt, duration, input_references

input_references ist ein Array von Objekten. Setzen Sie type auf image_url und verwenden Sie das dazu passende Feld mit url. Verwenden Sie öffentliche HTTPS-URLs. Lassen Sie frame_images weg, um den Referenzmodus auszuwählen. Kombinieren Sie Bildreferenzen nicht mit Frame-Bildern. Wählen Sie eine unterstützte Auflösung; ergänzen Sie ein Seitenverhältnis oder verwenden Sie eine aufgeführte Größe.

model: Typ: string · x-ai/grok-imagine-video

prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10.000 · Mindestens ein Zeichen außer Leerraum erforderlich: Ja

Methodenparameter und Lebenszyklus
ParameterVertrag
Parametercontent_typeVertragapplication/json
ParameterrequiredVertragmodel, prompt, duration
Parametermaterial_typesVertragtext, image
Parameteradditional_propertiesVertragfalse
Parameteroptional_controlsVertragresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user

Lebenszyklus: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Tarife

So wird die endgültige Gebühr berechnet

Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.

Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.

Schnellmodus
Nicht angegeben Wenn der Schnellmodus ausgewählt ist
Flex-Modus
Nicht angegeben Wenn der Modus flex ausgewählt ist
Maximaler Denkaufwand
Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird

Geschätzte Tarife zum Vergleich

Preise nach Konfiguration

Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.

KonfigurationTarifstaffelPrognostizierte MengeAbrechnungseinheitAbrechnungsbedingungenGebühr
KonfigurationBasistarife für TokenTarifstaffelGrundtarifPrognostizierte Menge—Abrechnungseinheit—Abrechnungsbedingungen—Gebühr
Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token
Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token
Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token
Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token
Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token
KonfigurationEingabebildTarifstaffel—Prognostizierte Menge—Abrechnungseinheitpro BildAbrechnungsbedingungenIn diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben.Gebühr
Eingabe · Eingabebild · Schätzung nur zum Vergleich $0.004 pro Bild
KonfigurationVideopreisTarifstaffel—Prognostizierte Menge—Abrechnungseinheitpro VideosekundeAbrechnungsbedingungenresolution: 480pGebühr
Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.1 pro Videosekunde
KonfigurationVideopreisTarifstaffel—Prognostizierte Menge—Abrechnungseinheitpro VideosekundeAbrechnungsbedingungenresolution: 720pGebühr
Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.14 pro Videosekunde
KonfigurationGeschätzte GenerierungskostenTarifstaffel—Prognostizierte MengeSchätzung für eine GenerierungAbrechnungseinheit—Abrechnungsbedingungen—Gebühr
Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.1 Schätzung vor der Generierung

Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung.

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 →

Details zum Referenztarif

Referenztarifstaffeln auf Modellebene ändern weder Methodenauswahl noch Kostenvoranschläge oder Gebühren. Für die aktive Abrechnung gelten die Tarife der ausgewählten Ailoot-Methode.

Preisreferenzen für Videokonfigurationen

Preise nach Konfiguration

Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.

KonfigurationAbrechnungsbedingungenGebühr
KonfigurationEingabebildAbrechnungsbedingungenIn diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben.Gebühr
Eingabe · Eingabebild $0.004 pro Bild

Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration.

KonfigurationVideopreisAbrechnungsbedingungenresolution: 480pGebühr
Ausgabe · Videopreis $0.1 pro Videosekunde

Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration.

KonfigurationVideopreisAbrechnungsbedingungenresolution: 720pGebühr
Ausgabe · Videopreis $0.14 pro Videosekunde

Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration.

Beispielanfragen

Ailoot Ultra · Video

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"x-ai/grok-imagine-video","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

Ergebnisse abrufen und speichern

Ailoot Ultra · Video

Signierte Inhalts-URLs der Ihnen zugeordneten Assets

  • GET /v1/videos/{public_id}
  • GET /v1/videos/{public_id}/content
Auftragsstatus prüfen
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
Abrufe anderer Inhalte
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n    target=Path('owned-'+label+'.bin')\n    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
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 jede tatsächlich erzeugte, Ihnen zugeordnete Ausgabe samt den zurückgegebenen gemessenen Metadaten auf.

Wenn die ursprüngliche Antwort geprüft werden muss

503 result_pending_check + ursprüngliche ID + X-Should-Retry:false; ursprüngliche Anfrage niemals wiederholen

Antwortfelder
FeldTypBedeutung
FeldindexTypintegerBedeutungBei null beginnende Position dieses Videos in der Ausgabeliste.
Feldcontent_urlTypstringBedeutungSignierte HTTPS-Download-URL für dieses fertiggestellte Video.
Feldsha256Typstring | nullBedeutungSHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar.
Feldsize_bytesTypinteger | nullBedeutungGröße der ursprünglichen Videodatei in Bytes; null, falls nicht verfügbar.
Feldduration_msTypinteger | nullBedeutungGemessene Videodauer in Millisekunden; null, falls nicht verfügbar.
FeldwidthTypinteger | nullBedeutungVideobreite in Pixeln; null, falls nicht verfügbar.
FeldheightTypinteger | nullBedeutungVideohöhe in Pixeln; null, falls nicht verfügbar.
Feldvideo_codecTypstring | nullBedeutungVideocodec-Kennung; null, falls nicht aufgezeichnet.
Feldhas_audioTypboolean | nullBedeutungGibt an, ob das Video eine Audiospur enthält; null, falls nicht gemessen.
Feldaudio_codecTypstring | nullBedeutungAudiocodec-Kennung; null, wenn keine Kennung aufgezeichnet wurde.
Fehler und nächste Schritte
AntwortBedingungNächster Schritt
Antwort404 · not_found_errorBedingungDer Videozugriff ist nicht verfügbar, oder diese Video-ID wurde nicht gefunden.Nächster SchrittPrüfen Sie den Videozugriff. Verwenden Sie für ein vorhandenes Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel.
Antwort401 · authentication_errorBedingungDer API-Schlüssel passt nicht zum authentifizierten Konto.Nächster SchrittPrüfen Sie vor der Übermittlung Ihren API-Schlüssel und den Kontozugriff.
Antwort400 · invalid_request_errorBedingungDie Anfrage konnte nicht gelesen werden, oder der Downloadindex ist ungültig.Nächster SchrittKorrigieren Sie den Anfrageinhalt. Wählen Sie für einen Download einen Ausgabeindex, den die ursprüngliche Aufgabe zurückgegeben hat.
Antwort422 · price_unavailableBedingungFür die ausgewählte Videokonfiguration lässt sich kein Preis bestimmen.Nächster SchrittWählen Sie eine unterstützte Videokonfiguration und ergänzen Sie die erforderlichen Optionen, bevor Sie eine korrigierte Anfrage senden.
Antwort422 · invalid_request_errorBedingungEine Videoeingabe oder die ursprüngliche Fortsetzungsaufgabe ist ungültig.Nächster SchrittVerwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung die öffentliche Video-ID Ihres fertiggestellten Originals mit demselben API-Schlüssel.
Antwort402 · billing_errorBedingungDas verfügbare Guthaben oder die geltenden Limits lassen keine Reservierung zu.Nächster SchrittPrüfen Sie Ihr verfügbares Guthaben und Ihre Limits, bevor Sie eine neue Anfrage senden.
Antwort503 · server_errorBedingungVideoprüfung, Speicherung oder Dienstzugriff sind vorübergehend nicht verfügbar.Nächster SchrittWarten Sie, bis der Dienst verfügbar ist. Wenn Sie bereits eine Video-ID haben, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Generierung zu erstellen.
Antwort503 · result_pending_checkBedingungDas ursprüngliche Videoergebnis und die Abrechnung müssen geprüft werden.Nächster SchrittBewahren Sie die zurückgegebene Video-ID auf und prüfen Sie diese Aufgabe. Senden Sie während der Prüfung keine ersetzende Generierungsanfrage.
Antwort503 · owned_result_unavailableBedingungDer Download des vorhandenen Videos ist vorübergehend nicht verfügbar.Nächster SchrittPrüfen Sie dieselbe Videoaufgabe später erneut und laden Sie ihre vorhandene Ausgabe herunter. Eine neue Generierung erstellt einen separaten Vorgang.
Antwort409 · video_not_readyBedingungDer Videoinhalt wurde nicht veröffentlicht.Nächster SchrittPrüfen Sie den Status der ursprünglichen Aufgabe. Laden Sie das Ergebnis herunter, sobald completed gemeldet wird; bei failed folgen Sie dem Hinweis zur Abrechnungsprüfung.

Aliasnamen

Modellaliasnamen

Ailoot Ultra x-ai/grok-imagine-video

Aliasnamen für Methodenpfade

Verwenden Sie die oben angezeigten Methodenpfade.

Zugehörige Aufrufer-IDs

x-ai/grok-imagine-video

", "method_identity": { "effective_request_model_id": "x-ai/grok-imagine-video", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "x-ai/grok-imagine-video", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|x-ai%2Fgrok-imagine-video", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Bewahren Sie jede tatsächlich erzeugte, Ihnen zugeordnete Ausgabe samt den zurückgegebenen gemessenen Metadaten auf.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Der Videozugriff ist nicht verfügbar, oder diese Video-ID wurde nicht gefunden.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Prüfen Sie den Videozugriff. Verwenden Sie für ein vorhandenes Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel.", "type": "not_found_error" }, { "condition": "Der API-Schlüssel passt nicht zum authentifizierten Konto.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Prüfen Sie vor der Übermittlung Ihren API-Schlüssel und den Kontozugriff.", "type": "authentication_error" }, { "condition": "Die Anfrage konnte nicht gelesen werden, oder der Downloadindex ist ungültig.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Korrigieren Sie den Anfrageinhalt. Wählen Sie für einen Download einen Ausgabeindex, den die ursprüngliche Aufgabe zurückgegeben hat.", "type": "invalid_request_error" }, { "condition": "Für die ausgewählte Videokonfiguration lässt sich kein Preis bestimmen.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Wählen Sie eine unterstützte Videokonfiguration und ergänzen Sie die erforderlichen Optionen, bevor Sie eine korrigierte Anfrage senden.", "type": "price_unavailable" }, { "condition": "Eine Videoeingabe oder die ursprüngliche Fortsetzungsaufgabe ist ungültig.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Verwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung die öffentliche Video-ID Ihres fertiggestellten Originals mit demselben API-Schlüssel.", "type": "invalid_request_error" }, { "condition": "Das verfügbare Guthaben oder die geltenden Limits lassen keine Reservierung zu.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Prüfen Sie Ihr verfügbares Guthaben und Ihre Limits, bevor Sie eine neue Anfrage senden.", "type": "billing_error" }, { "condition": "Videoprüfung, Speicherung oder Dienstzugriff sind vorübergehend nicht verfügbar.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Warten Sie, bis der Dienst verfügbar ist. Wenn Sie bereits eine Video-ID haben, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Generierung zu erstellen.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Das ursprüngliche Videoergebnis und die Abrechnung müssen geprüft werden.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Bewahren Sie die zurückgegebene Video-ID auf und prüfen Sie diese Aufgabe. Senden Sie während der Prüfung keine ersetzende Generierungsanfrage.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Der Download des vorhandenen Videos ist vorübergehend nicht verfügbar.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Prüfen Sie dieselbe Videoaufgabe später erneut und laden Sie ihre vorhandene Ausgabe herunter. Eine neue Generierung erstellt einen separaten Vorgang.", "type": "server_error" }, { "condition": "Der Videoinhalt wurde nicht veröffentlicht.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Prüfen Sie den Status der ursprünglichen Aufgabe. Laden Sie das Ergebnis herunter, sobald completed gemeldet wird; bei failed folgen Sie dem Hinweis zur Abrechnungsprüfung.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + ursprüngliche ID + X-Should-Retry:false; ursprüngliche Anfrage niemals wiederholen" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "x-ai/grok-imagine-video" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Geben Sie prompt als Text und duration in ganzen Sekunden an. Wählen Sie eine unterstützte Auflösung; ergänzen Sie ein Seitenverhältnis oder verwenden Sie eine aufgeführte Größe.", "required": [ "model", "prompt", "duration" ], "required_material": "Ein schriftlicher Prompt." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "x-ai/grok-imagine-video" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images ist ein Array. Jedes Frame-Objekt enthält type, image_url und frame_type; image_url enthält url. Setzen Sie type auf image_url. Verwenden Sie first_frame. Jede Frame-Rolle darf höchstens einmal vorkommen. Geben Sie für jeden Frame eine öffentliche HTTPS-Bild-URL an. Verwenden Sie in einer Anfrage entweder Frame-Bilder oder Bildreferenzen; kombinieren Sie nicht beides. Wählen Sie eine unterstützte Auflösung; ergänzen Sie ein Seitenverhältnis oder verwenden Sie eine aufgeführte Größe.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Ein schriftlicher Prompt und ein Bild für den ersten Frame." }, { "mode": "Reference to video", "model": { "enum": [ "x-ai/grok-imagine-video" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references ist ein Array von Objekten. Setzen Sie type auf image_url und verwenden Sie das dazu passende Feld mit url. Verwenden Sie öffentliche HTTPS-URLs. Lassen Sie frame_images weg, um den Referenzmodus auszuwählen. Kombinieren Sie Bildreferenzen nicht mit Frame-Bildern. Wählen Sie eine unterstützte Auflösung; ergänzen Sie ein Seitenverhältnis oder verwenden Sie eine aufgeführte Größe.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Ein schriftlicher Prompt und unterstützte Bildreferenzen." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Bei null beginnende Position dieses Videos in der Ausgabeliste.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signierte HTTPS-Download-URL für dieses fertiggestellte Video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Größe der ursprünglichen Videodatei in Bytes; null, falls nicht verfügbar.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Gemessene Videodauer in Millisekunden; null, falls nicht verfügbar.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videobreite in Pixeln; null, falls nicht verfügbar.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videohöhe in Pixeln; null, falls nicht verfügbar.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Videocodec-Kennung; null, falls nicht aufgezeichnet.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Gibt an, ob das Video eine Audiospur enthält; null, falls nicht gemessen.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audiocodec-Kennung; null, wenn keine Kennung aufgezeichnet wurde.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "Signierte Inhalts-URLs der Ihnen zugeordneten Assets", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "x-ai/grok-imagine-video" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "x-ai/grok-imagine-video" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480p", "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "480p", "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "3:2", "2:3" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "3:2", "2:3" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Diese Schlüssel beschreiben jedes Frame-Objekt; image_url enthält ausschließlich url. Lassen Sie frame_images bei einer reinen Textanfrage weg.", "content": "Array von Frame-Objekten. Jedes Objekt enthält type=image_url, image_url mit url und frame_type. Verwenden Sie eine HTTPS-Bild-URL und setzen Sie frame_type auf first_frame. Jede Frame-Rolle darf höchstens einmal vorkommen.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 1, "max_items": 1, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "854x480", "1280x720", "480x854", "720x1280", "480x480", "720x720", "640x480", "960x720", "480x640", "720x960", "720x480", "1080x720", "480x720", "720x1080" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "854x480", "1280x720", "480x854", "720x1280", "480x480", "720x720", "640x480", "960x720", "480x640", "720x960", "720x480", "1080x720", "480x720", "720x1080" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "3:2", "2:3" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "x-ai/grok-imagine-video" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "480p", "720p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "854x480", "1280x720", "480x854", "720x1280", "480x480", "720x720", "640x480", "960x720", "480x640", "720x960", "720x480", "1080x720", "480x720", "720x1080" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Frame images plus image references are rejected because mixed additive input count is unproved; pure frame or pure reference mode remains separately priced." ] }, "unsupported": [ "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per image" }, "label": "Input image", "units": [ { "amount": "0.004", "amount_unit": "usd_per_image", "billing_input": false, "estimate_only": true, "key": "cents_per_image_input", "label": "Input image", "native_amount_usd_per_unit": "0.004", "native_quantity": 1, "public_unit_label": "per image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "image" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Videopreis", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_video_output_second_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 720p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.14", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_video_output_second_720p", "label": "Video price", "native_amount_usd_per_unit": "0.14", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Geschätzte Generierungskosten", "units": [ { "amount": "0.1", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"x-ai/grok-imagine-video\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"720p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per image" }, "label": "Input image", "units": [ { "amount": "0.004", "amount_unit": "usd_per_image", "billing_input": false, "estimate_only": true, "key": "cents_per_image_input", "label": "Input image", "native_amount_usd_per_unit": "0.004", "native_quantity": 1, "public_unit_label": "per image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "image" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_video_output_second_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 720p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.14", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_video_output_second_720p", "label": "Video price", "native_amount_usd_per_unit": "0.14", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.1", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "x-ai/grok-imagine-video", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.004", "amount_unit": "usd_per_image", "billing_input": false, "estimate_only": true, "key": "cents_per_image_input", "label": "Input image", "native_amount_usd_per_unit": "0.004", "native_quantity": 1, "public_unit_label": "per image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "image" }, { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_video_output_second_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.14", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_video_output_second_720p", "label": "Video price", "native_amount_usd_per_unit": "0.14", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.1", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "x-ai/grok-imagine-video", "nativeProvenance": { "input_facts_canonical_sha256": "3201e1a8ff3a56ea5b2c128df3a1d43ea4a26a6fbd3b298593974e2b3e23cd9c", "input_html_sha256": "572625bb895f446b543c159157af86b1231bac3700e058004b1dad7a9e484625", "private_audit_sha256": "cf7cc0fb9e8f22f3ca606ad9749b438d19cf971b3047d45f140d49162480dae9", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/de/x-ai-grok-imagine-video/", "description": "Grok Imagine Video erzeugt kurze Clips aus Text, einem Anfangsbild oder bis zu sieben visuellen Referenzen. Seine klassische Modellversion bearbeitet außerdem vorhandene MP4-Clips und ergänzt 2–10 Sekunden Fortsetzung. Generierung erreicht 720p mit Audio; Bearbeitung und Erweiterung bewahren den Quellbildausschnitt innerhalb eigener Grenzen.", "locale": "de", "md_url": "https://ailoot.ai/models/de/x-ai-grok-imagine-video/index.md", "title": "SpaceXAI: Grok Imagine Video — Ailoot", "url": "https://ailoot.ai/models/de/x-ai-grok-imagine-video/" }, "rawModel": { "about": "Grok Imagine Video ist die klassische Modellversion der Grok-Imagine-Videofamilie. Die aktuelle Herstellerdokumentation behandelt die Erzeugung eines neuen Clips aus einem Prompt, die Animation eines Anfangsbildes, die Verwendung visueller Referenzen sowie Änderung oder Fortsetzung eines vorhandenen Videos. Diese Workflows erzeugen unterschiedliche Ergebnisse: eine neue Szene, eine bearbeitete Fassung bereitgestellten Materials oder ein Video mit ursprünglichem Material und anschließenden neuen Inhalten. Wählen Sie den Workflow anhand des bereits vorhandenen Materials und des zu ändernden Teils der Einstellung.\n\nBeschreiben Sie für eine neue Text-zu-Video-Einstellung Motiv, Umgebung, sichtbare Handlung, Kamera und Ton. Standardgenerierung unterstützt Clips von 1–15 Sekunden mit 480p- oder 720p-Ausgabe und erzeugtem Audio. Quadratische, querformatige, hochformatige und breitere Seitenverhältnisse sind dokumentiert, darunter 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 und 5:2. Ein eigenes Briefing könnte eine Papierlaterne verlangen, die sich sanft über einem ruhigen Innenhof bewegt, während die Kamera seitlich fährt. Die nützliche Prüfung bewertet, ob Bewegung, Bildausschnitt und Umgebungston diese eine Einstellung unterstützen.\n\nBei Bild-zu-Video ist das bereitgestellte Standbild das erste Videobild. Bereiten Sie es mit vorgesehenem Beschnitt, Motiv und sichtbaren Details vor und beschreiben Sie anschließend die folgende Handlung. Die Ausgabe folgt dem Seitenverhältnis des Bildes. Ein Anfangsstandbild liefert eine genaue Eröffnungskomposition; Referenz-zu-Video verwendet dagegen Bilder zur Steuerung von Personen, Produkten oder Umgebung in einer neu komponierten Szene. Diese beiden Rollen auseinanderzuhalten hilft, einen unbeabsichtigten Anfang zu vermeiden, wenn ein bekanntes Objekt in einer anderen Umgebung erscheinen soll.\n\nDas klassische Modell akzeptiert bis zu sieben Referenzbilder pro referenzgestützter Anfrage. Dieser Modus ist auf zehn Sekunden und 720p begrenzt. Geben Sie jeder Referenz eine klare Rolle und identifizieren Sie sie anhand ihrer Listenposition, beginnend mit . Für eine kurze Produktszene kann eine Referenz das Objekt und eine andere den gewünschten Ort bestimmen. Konzentrieren Sie das Briefing auf die Objektplatzierung und die Haupthandlung der Einstellung. Der klassische Referenzmodus verwendet eine eigene Konfiguration; die vollständige 1.5-Version liefert zusätzliche Steuerung für ausgewählte Stimmen und festgelegte Bilder.\n\nVideobearbeitung nimmt einen vorhandenen Clip und einen Prompt zur gewünschten Änderung entgegen. Der Hersteller akzeptiert MP4-Quellen mit unterstützten Codecs wie H.264, H.265 oder AV1 und bis zu 8,7 Sekunden Länge. Das bearbeitete Ergebnis bewahrt Quelldauer und Seitenverhältnis und folgt der Quellauflösung bis zu einer Obergrenze von 720p. Benutzerdefinierte Steuerung für Dauer, Seitenverhältnis und Auflösung gilt für diesen Bearbeitungsworkflow nicht. Bereiten Sie eine Quelle vor, die die für die endgültige Nutzung benötigte Komposition und Zeitgestaltung bereits enthält, damit der Prompt sich auf die vorgesehene visuelle Änderung konzentrieren kann.\n\nEin eigenes Bearbeitungsbriefing könnte die Farbe eines Schals ändern und dabei Gesicht, Bewegung, Hintergrund und Kamera der Person bewahren. Benennen Sie diese erhaltenen Elemente ausdrücklich neben der Änderung. Der Hersteller beschreibt das möglichst genaue Bewahren der übrigen Quelle; dies ist ein nützliches Prüfziel, keine Garantie identischer Pixel. Vergleichen Sie das Ergebnis über den gesamten Clip, besonders wenn das Objekt sich bewegt, ein anderes Objekt kreuzt oder teilweise verdeckt wird. Das fertige Ergebnis ist der bearbeitete Clip, nicht lediglich ein Standbild mit der neuen Farbe.\n\nVideoerweiterung setzt am letzten Bild eines vorhandenen MP4 an. Die dokumentierte Quelllänge beträgt 2–15 Sekunden; der ergänzte Teil beträgt 2–10 Sekunden mit sechs Sekunden als Standard. Die Erweiterungsdauer betrifft nur den neuen Teil. Eine zehnsekündige Quelle mit anschließenden fünf Sekunden Fortsetzung erzeugt ein fünfzehnsekündiges Video mit beiden Teilen. Das Ergebnis bewahrt Quellseitenverhältnis und Auflösung innerhalb einer Obergrenze von 720p. Bereiten Sie den letzten Moment der Quelle vor und beschreiben Sie das folgende Geschehen, etwa das Motiv, das sich einem näher kommenden Objekt zuwendet, während die Kamera ihre aktuelle Bewegung fortsetzt.\n\nPrüfen Sie eine Erweiterung rund um die Grenze zwischen Quelle und neuem Inhalt. Prüfen Sie Motividentität, Bewegungsrichtung, Kameratempo, Licht und Ton, damit die Fortsetzung zur vorangegangenen Handlung passt. Wenn ein Clip an einem visuell ungünstigen Punkt endet, machen Sie diese Grenze zu einem ausdrücklichen Teil der Planung für die nächste Einstellung. Die Zusammenstellung längerer Szenen ist eine Schnittentscheidung: Die Dauergrenzen für Generierung, Referenz, Bearbeitung und Erweiterung sind separat; das Gesamtergebnis einer Erweiterung kann länger als ein gewöhnlicher neu generierter Clip sein.\n\nDer Videoworkflow des Herstellers ist asynchron. Eine Anfragekennung verfolgt eine Aufgabe, bis ein fertiges Ergebnis Videoadresse und Dauer liefert; Ausgabeadressen sind vorübergehend. Bewahren Sie bei der Produktionsschnittvorbereitung das abspielbare Ergebnis und sein Quellmaterial auf. Vollständiges Grok Imagine Video 1.5 bietet native 1080p-Generierung und umfangreichere visuelle, Stimmen- und Bildverankerung; Lite dient einfachen Prompts oder Arbeit mit einem Anfangsbild. Die klassische Modellversion bleibt nützlich, wenn das Ausgangsmaterial bereits ein Video ist, das gezielte Änderung oder Fortsetzung benötigt.", "alias_of": null, "aliases": [], "author": "SpaceXAI", "available": null, "canonical_model": "x-ai/grok-imagine-video", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.1", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Die vollständigen Preisangaben zur Konfiguration finden Sie in den Details." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "5028ba460dfc0ba205d6f290", "label": "Preisreferenzen für Videokonfigurationen", "profiles": [ { "basis": "Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration.", "dimensions": { "conditions": "In diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben." }, "label": "Eingabebild", "units": [ { "amount": "0.004", "amount_unit": "usd_per_image", "billing_input": false, "key": "input_image", "label": "Input image", "public_unit_label": "per image", "quantity": 1, "rate_role": "typed_video_image_reference", "side": "in", "unit": "image" } ] }, { "basis": "Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration.", "dimensions": { "conditions": "resolution: 480p" }, "label": "Videopreis", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration.", "dimensions": { "conditions": "resolution: 720p" }, "label": "Videopreis", "units": [ { "amount": "0.14", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "x-ai/grok-imagine-video", "input": [ "text", "image" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Bewahren Sie jede tatsächlich erzeugte, Ihnen zugeordnete Ausgabe samt den zurückgegebenen gemessenen Metadaten auf.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Der Videozugriff ist nicht verfügbar, oder diese Video-ID wurde nicht gefunden.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Prüfen Sie den Videozugriff. Verwenden Sie für ein vorhandenes Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel.", "type": "not_found_error" }, { "condition": "Der API-Schlüssel passt nicht zum authentifizierten Konto.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Prüfen Sie vor der Übermittlung Ihren API-Schlüssel und den Kontozugriff.", "type": "authentication_error" }, { "condition": "Die Anfrage konnte nicht gelesen werden, oder der Downloadindex ist ungültig.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Korrigieren Sie den Anfrageinhalt. Wählen Sie für einen Download einen Ausgabeindex, den die ursprüngliche Aufgabe zurückgegeben hat.", "type": "invalid_request_error" }, { "condition": "Für die ausgewählte Videokonfiguration lässt sich kein Preis bestimmen.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Wählen Sie eine unterstützte Videokonfiguration und ergänzen Sie die erforderlichen Optionen, bevor Sie eine korrigierte Anfrage senden.", "type": "price_unavailable" }, { "condition": "Eine Videoeingabe oder die ursprüngliche Fortsetzungsaufgabe ist ungültig.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Verwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung die öffentliche Video-ID Ihres fertiggestellten Originals mit demselben API-Schlüssel.", "type": "invalid_request_error" }, { "condition": "Das verfügbare Guthaben oder die geltenden Limits lassen keine Reservierung zu.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Prüfen Sie Ihr verfügbares Guthaben und Ihre Limits, bevor Sie eine neue Anfrage senden.", "type": "billing_error" }, { "condition": "Videoprüfung, Speicherung oder Dienstzugriff sind vorübergehend nicht verfügbar.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Warten Sie, bis der Dienst verfügbar ist. Wenn Sie bereits eine Video-ID haben, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Generierung zu erstellen.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Das ursprüngliche Videoergebnis und die Abrechnung müssen geprüft werden.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Bewahren Sie die zurückgegebene Video-ID auf und prüfen Sie diese Aufgabe. Senden Sie während der Prüfung keine ersetzende Generierungsanfrage.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Der Download des vorhandenen Videos ist vorübergehend nicht verfügbar.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Prüfen Sie dieselbe Videoaufgabe später erneut und laden Sie ihre vorhandene Ausgabe herunter. Eine neue Generierung erstellt einen separaten Vorgang.", "type": "server_error" }, { "condition": "Der Videoinhalt wurde nicht veröffentlicht.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Prüfen Sie den Status der ursprünglichen Aufgabe. Laden Sie das Ergebnis herunter, sobald completed gemeldet wird; bei failed folgen Sie dem Hinweis zur Abrechnungsprüfung.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + ursprüngliche ID + X-Should-Retry:false; ursprüngliche Anfrage niemals wiederholen" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "x-ai/grok-imagine-video" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Geben Sie prompt als Text und duration in ganzen Sekunden an. Wählen Sie eine unterstützte Auflösung; ergänzen Sie ein Seitenverhältnis oder verwenden Sie eine aufgeführte Größe.", "required": [ "model", "prompt", "duration" ], "required_material": "Ein schriftlicher Prompt." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "x-ai/grok-imagine-video" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images ist ein Array. Jedes Frame-Objekt enthält type, image_url und frame_type; image_url enthält url. Setzen Sie type auf image_url. Verwenden Sie first_frame. Jede Frame-Rolle darf höchstens einmal vorkommen. Geben Sie für jeden Frame eine öffentliche HTTPS-Bild-URL an. Verwenden Sie in einer Anfrage entweder Frame-Bilder oder Bildreferenzen; kombinieren Sie nicht beides. Wählen Sie eine unterstützte Auflösung; ergänzen Sie ein Seitenverhältnis oder verwenden Sie eine aufgeführte Größe.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Ein schriftlicher Prompt und ein Bild für den ersten Frame." }, { "mode": "Reference to video", "model": { "enum": [ "x-ai/grok-imagine-video" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references ist ein Array von Objekten. Setzen Sie type auf image_url und verwenden Sie das dazu passende Feld mit url. Verwenden Sie öffentliche HTTPS-URLs. Lassen Sie frame_images weg, um den Referenzmodus auszuwählen. Kombinieren Sie Bildreferenzen nicht mit Frame-Bildern. Wählen Sie eine unterstützte Auflösung; ergänzen Sie ein Seitenverhältnis oder verwenden Sie eine aufgeführte Größe.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Ein schriftlicher Prompt und unterstützte Bildreferenzen." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Bei null beginnende Position dieses Videos in der Ausgabeliste.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signierte HTTPS-Download-URL für dieses fertiggestellte Video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Größe der ursprünglichen Videodatei in Bytes; null, falls nicht verfügbar.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Gemessene Videodauer in Millisekunden; null, falls nicht verfügbar.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videobreite in Pixeln; null, falls nicht verfügbar.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videohöhe in Pixeln; null, falls nicht verfügbar.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Videocodec-Kennung; null, falls nicht aufgezeichnet.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Gibt an, ob das Video eine Audiospur enthält; null, falls nicht gemessen.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audiocodec-Kennung; null, wenn keine Kennung aufgezeichnet wurde.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "Signierte Inhalts-URLs der Ihnen zugeordneten Assets", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "x-ai/grok-imagine-video" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "x-ai/grok-imagine-video" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480p", "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "480p", "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "3:2", "2:3" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "3:2", "2:3" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Diese Schlüssel beschreiben jedes Frame-Objekt; image_url enthält ausschließlich url. Lassen Sie frame_images bei einer reinen Textanfrage weg.", "content": "Array von Frame-Objekten. Jedes Objekt enthält type=image_url, image_url mit url und frame_type. Verwenden Sie eine HTTPS-Bild-URL und setzen Sie frame_type auf first_frame. Jede Frame-Rolle darf höchstens einmal vorkommen.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 1, "max_items": 1, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "854x480", "1280x720", "480x854", "720x1280", "480x480", "720x720", "640x480", "960x720", "480x640", "720x960", "720x480", "1080x720", "480x720", "720x1080" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "854x480", "1280x720", "480x854", "720x1280", "480x480", "720x720", "640x480", "960x720", "480x640", "720x960", "720x480", "1080x720", "480x720", "720x1080" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "3:2", "2:3" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "x-ai/grok-imagine-video" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "480p", "720p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "854x480", "1280x720", "480x854", "720x1280", "480x480", "720x720", "640x480", "960x720", "480x640", "720x960", "720x480", "1080x720", "480x720", "720x1080" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Frame images plus image references are rejected because mixed additive input count is unproved; pure frame or pure reference mode remains separately priced." ] }, "unsupported": [ "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per image" }, "label": "Input image", "units": [ { "amount": "0.004", "amount_unit": "usd_per_image", "billing_input": false, "estimate_only": true, "key": "cents_per_image_input", "label": "Input image", "native_amount_usd_per_unit": "0.004", "native_quantity": 1, "public_unit_label": "per image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "image" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Videopreis", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_video_output_second_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 720p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.14", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_video_output_second_720p", "label": "Video price", "native_amount_usd_per_unit": "0.14", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Geschätzte Generierungskosten", "units": [ { "amount": "0.1", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"x-ai/grok-imagine-video\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"720p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per image" }, "label": "Input image", "units": [ { "amount": "0.004", "amount_unit": "usd_per_image", "billing_input": false, "estimate_only": true, "key": "cents_per_image_input", "label": "Input image", "native_amount_usd_per_unit": "0.004", "native_quantity": 1, "public_unit_label": "per image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "image" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_video_output_second_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 720p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.14", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_video_output_second_720p", "label": "Video price", "native_amount_usd_per_unit": "0.14", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.1", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "x-ai/grok-imagine-video", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.004", "amount_unit": "usd_per_image", "billing_input": false, "estimate_only": true, "key": "cents_per_image_input", "label": "Input image", "native_amount_usd_per_unit": "0.004", "native_quantity": 1, "public_unit_label": "per image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "image" }, { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_video_output_second_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.14", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_video_output_second_720p", "label": "Video price", "native_amount_usd_per_unit": "0.14", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.1", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "x-ai/grok-imagine-video", "request_model_id": "x-ai/grok-imagine-video", "route_label": "Ultra" } ], "name": "SpaceXAI: Grok Imagine Video", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.1, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.1, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_assets_additive": true, "resolution": "480p" }, "label": "Ultra", "units": [ { "amount": "0.10", "amount_unit": "usd_per_output_video_second", "conditions": { "input_assets_additive": true, "resolution": "480p" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_assets_additive": true, "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.14", "amount_unit": "usd_per_output_video_second", "conditions": { "input_assets_additive": true, "resolution": "720p" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "start_frame_or_reference_image_charged": true }, "label": "Ultra", "units": [ { "amount": "0.004", "amount_unit": "usd_per_input_image", "conditions": { "adds_to_output": true, "start_frame_or_reference_image_charged": true }, "key": "input_image", "label": "input image", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_image" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output_seconds": true }, "label": "Ultra", "units": [ { "amount": "0.02", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output_seconds": true }, "key": "input_video", "label": "input video", "profile_index": 3, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.004", "amount_unit": "usd_per_exact_physical_unit", "basis": "image input", "billing_original_currency": "USD_cent", "billing_original_rate": "0.4", "key": "cents_per_image_input", "label": "image input", "native_amount_usd_per_unit": "0.004", "native_quantity": 1, "quantity": 1, "side": "in", "unit": "image_input" }, { "amount": "0.10", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=480p", "billing_original_currency": "USD_cent", "billing_original_rate": "10", "key": "cents_per_video_output_second_480p", "label": "output second", "native_amount_usd_per_unit": "0.10", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.14", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=720p", "billing_original_currency": "USD_cent", "billing_original_rate": "14", "key": "cents_per_video_output_second_720p", "label": "output second", "native_amount_usd_per_unit": "0.14", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" } ] } ], "public_id": "x-ai/grok-imagine-video", "short": "Grok Imagine Video erzeugt kurze Clips aus Text, einem Anfangsbild oder bis zu sieben visuellen Referenzen. Seine klassische Modellversion bearbeitet außerdem vorhandene MP4-Clips und ergänzt 2–10 Sekunden Fortsetzung. Generierung erreicht 720p mit Audio; Bearbeitung und Erweiterung bewahren den Quellbildausschnitt innerhalb eigener Grenzen." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "Grok Imagine Video erzeugt kurze Clips aus Text, einem Anfangsbild oder bis zu sieben visuellen Referenzen. Seine klassische Modellversion bearbeitet außerdem vorhandene MP4-Clips und ergänzt 2–10 Sekunden Fortsetzung. Generierung erreicht 720p mit Audio; Bearbeitung und Erweiterung bewahren den Quellbildausschnitt innerhalb eigener Grenzen.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "7f344ad5f768d3ec07fef8917a96b25036c1e674d9a23821c76a61568d9b5af7", "renderer_sha256": "8bd3076b303b7b3aa4d961032854071403a471ec26a4f50c64e3a32556ea2925" }, "sourceRevision": "3a28ea1c389cebc315c3e39dc10a4a8c5a3d0afb210ba9d0b1c7f5f3d7df6457" }