grok-imagine-video-1.5-preview
Grok Imagine Video 1.5 crée des vidéos à partir de texte d’une durée de 1–15 secondes, y compris en 1080p. Le modèle lui-même prend en charge l’animation d’images, les références visuelles, la définition d’images clés et une piste sonore.
À propos du modèle
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
La création d’une scène vidéo
Grok Imagine Video 1.5 est un modèle de xAI pour générer des vidéos à partir d’une description textuelle et de contenus visuels. La méthode actuelle d’Ailoot publie la génération textuelle ; les modes supplémentaires du modèle lui-même permettent d’animer une image, d’utiliser des références et de définir des images clés de la scène.
Le résultat est créé de façon asynchrone : après la création de la tâche, sa disponibilité est vérifiée à l’aide de son identifiant. Selon xAI, le processus peut prendre plusieurs minutes en fonction de la difficulté de la scène, de la durée et de la résolution. Recevoir l’identifiant de la tâche ne signifie pas encore que la vidéo est prête.
La durée, les proportions et la résolution
La vidéo créée dure de 1 à 15 secondes. Les formats 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 ou 2:3 peuvent être choisis ; pour le texte, le format standard est 16:9. Lors de l’animation d’une image, ses proportions sont conservées par défaut.
Pour la génération à partir de texte et d’une image initiale, 480p, 720p et 1080p sont disponibles. 480p est utilisé par défaut ; le mode avec des références est limité à 720p. Le 1080p ne peut pas être transposé à tous les modes du seul fait qu’il est disponible dans le modèle.
Le contrôle de l’apparence
Dans le mode avec références, xAI accepte jusqu’à 7 images. Elles définissent les personnes, les objets, les vêtements et d’autres caractéristiques visuelles, sans fixer la première image. Ce mode vise les scènes avec un personnage récurrent, les démonstrations de produits et la conservation de l’apparence souhaitée entre des mises en scène.
La première, la dernière et les images intermédiaires
La version 1.5 permet de fixer exactement la première image, la dernière image ou les deux à la fois. Si seule la dernière est définie, le modèle construit lui-même le début et aboutit à l’image indiquée. Avec les deux limites définies, il crée le mouvement entre elles ; la consigne textuelle peut préciser le mouvement et le travail de la caméra.
Pour le scénarimage au sein de la vidéo, jusqu’à 4 images clés peuvent être fixées. Le temps de chacune doit être strictement après le début et avant la fin ; le placement suit une grille de 1/3 de seconde. Deux images arrondies au même point de la grille sont rejetées. Pour l’éviter, laissez au moins 1/3 de seconde entre elles. La première et la dernière image sont définies séparément de ces quatre images intermédiaires.
Les images clés fixées peuvent être combinées aux références visuelles et aux voix prédéfinies. Si au moins une image est fixée, la description textuelle est facultative : la séquence d’images elle-même définit la scène. Les images clés ne peuvent pas être utilisées avec le mode de retouche vidéo. Ces fonctions de xAI ne signifient pas qu’elles sont disponibles dans la génération textuelle publiée par Ailoot.
Le son et les voix
La vidéo créée comporte une piste sonore par défaut ; un résultat sans son est également prévu. Dans le mode de xAI avec références vocales, on peut choisir jusqu’à 3 voix prédéfinies et les associer aux participants de la scène qui parlent.
La transmission de son propre fichier audio comme échantillon vocal n’est pas une fonction générale de ce modèle : xAI la propose séparément sur demande. Une voix prédéfinie et un fichier audio téléversé sont deux types d’entrées différents.
Les modes de travail
La génération textuelle crée une nouvelle scène ; l’image initiale définit son début ; les références guident l’apparence ; les images fixées définissent les repères visuels dans le temps. Chaque mode a ses propres limites : les réglages d’un mode ne doivent donc pas être transposés sans condition à un autre.
Ailoot · Vidéo POST /v1/videos/generations grok-imagine-video-1.5-preview
grok-imagine-video-1.5-preview
grok-imagine-video-1.5-previewPour commencer
Grok Imagine Video 1.5 crée des vidéos à partir de texte d’une durée de 1–15 secondes, y compris en 1080p. Le modèle lui-même prend en charge l’animation d’images, les références visuelles, la définition d’images clés et une piste sonore.
- Entrées acceptées
- Texte
- Résultats
- Vidéo
Disponible dans Ailoot · entrées et méthodes
Ailoot · Vidéo POST /v1/videos/generations
- Entrée
text- Sortie
video- Format de sortie
- mp4
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites grok-imagine-video-1.5-preview | Par défaut— |
Champprompt | Typestring | ExigenceFacultatif | Valeurs et limites Longueur minimale: 1 | Par défaut— |
Champduration | Typeinteger | ExigenceFacultatif | Valeurs et limites Minimum: 1 Maximum: 15 Conditions: Ne fournissez pas duration et seconds en même temps Unité: secondes | Par défaut1 |
Champseconds | Typeinteger|integer_string | ExigenceFacultatif | Valeurs et limites Minimum: 1 Maximum: 15 Alternative: duration | Par défaut— |
Champresolution | Typestring | ExigenceFacultatif | Valeurs et limites 480p, 720p, 1080p | Par défaut480p |
Champaspect_ratio | Typestring | ExigenceFacultatif | Valeurs et limites 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Conditions: Si une image d’entrée est fournie et que le rapport est omis, le fournisseur reprend le rapport de forme de l’image | Par défaut16:9 |
Champsize | Typestring | ExigenceFacultatif | Valeurs et limites 1280x720, 720x1280, 1920x1080, 1080x1920 Conditions: Doit correspondre à resolution/aspect_ratio si les deux sont indiqués | Par défaut— |
Champimage | Typeobject | ExigenceFacultatif | Valeurs et limites Conditions: Image d’entrée réelle prise en charge; permet d’omettre l’invite | Par défaut— |
Combinaisons d’éléments d’entrée
Texte vers vidéo · Obligatoire : prompt
Image vers vidéo · Obligatoire : image
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrematerial_types | Contrattext |
Paramètrerequired | Contratnull |
Paramètreoptional_controls | Contratnull |
Cycle de vie : submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Les structures des méthodes et les ID sont exacts ; la capacité du fournisseur est distincte de l’admission des requêtes.
Tarifs
Tarifs des méthodes Ailoot
POST /v1/videos/generations- Entrée
- 0,01 USD par image en entrée
- Sortie
- 0,25 USD par seconde en 1080p
- Sortie
- 0,08 USD par seconde en 480p
- Sortie
- 0,14 USD par seconde en 720p
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Exemples de requêtes
Ailoot · Vidéo
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "grok-imagine-video-1.5-preview", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'Recevoir et enregistrer les résultats
Ailoot · Vidéo
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Vérifier l’état de la tâche
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
-H "Authorization: Bearer $AILOOT_API_KEY"Autres lectures de contenu
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" \
--output video.mp4Conserver tous les résultats terminés
Enregistrez chaque vidéo terminée ou fichier renvoyé ; récupérez chaque URL de ressource effectivement renvoyée.
Conservez le JSON d’état complet et le request_id réel. Une réponse terminée avec status=done contient video.url avec une URL de contenu appartenant à votre compte. Préservez la durée indiquée et chaque champ de résultat retourné.
Si la réponse d’origine doit être vérifiée
Consultez la tâche d’origine existante; ne soumettez jamais de nouveau un envoi dont l’état est inconnu.
Champs de la réponse
| Champ | Type |
|---|---|
Champrequest_id | Typestring |
Champid | Typestring |
Champstatus | Typestring |
Champvideo.url | Typeowned signed content URL |
Champvideo.duration | Typenumber |
Champvideo.respect_moderation | Typeboolean |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamps obligatoires, représentation des éléments fournis ou valeur de paramètre invalides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
Réponse409 · video_not_ready | ConditionLe contenu du résultat d’origine n’est pas encore disponible | Étape suivanteInterrogez l’identifiant d’origine retourné et respectez Retry-After. |
Réponseserver_error | ConditionLa réponse renvoyée indique que l’opération ou le résultat nécessite une vérification | Étape suivanteConservez l’identifiant d’opération/de tâche initialement renvoyé, les en-têtes de la requête et la réponse ; poursuivez les lectures prises en charge de cette opération d’origine. Ne soumettez pas à nouveau la requête de création. |
Alias
Alias du modèle
Ailoot grok-imagine-video-1.5-preview
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · grok-imagine-video-1.5-preview
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/videos/generations·grok-imagine-video-1.5-preview:text→video- Quels champs la requête utilise-t-elle ?
POST /v1/videos/generations·grok-imagine-video-1.5-preview:model,prompt,duration,seconds,resolution,aspect_ratio,size,image- Quelles limites s’appliquent ?
POST /v1/videos/generations·grok-imagine-video-1.5-preview:duration.minimum:1;duration.maximum:15;seconds.minimum:1;seconds.maximum:15