grok-imagine-video
Grok Imagine Video crée de courtes vidéos à partir d’une description textuelle, avec un choix de durée et de format. Le modèle de xAI lui-même prend aussi en charge l’animation d’images et la retouche ciblée de vidéos.
À 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.
De la description à la vidéo
Grok Imagine Video crée une vidéo à partir de texte. Le modèle de xAI lui-même dispose également de modes avec une image et une vidéo sources. Dans la méthode de génération publiée par Ailoot, l’entrée est une description textuelle et le résultat une vidéo.
La génération est asynchrone : une tâche est d’abord créée, puis son état et le résultat final sont récupérés à l’aide de son identifiant. Selon xAI, la création d’une vidéo peut prendre plusieurs minutes ; le délai dépend de la difficulté de la scène, de la durée, de la résolution et du mode choisi.
La durée et le format
La création d’une vidéo propose une durée de 1 à 15 secondes. Les formats comprennent 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 et 2:3 ; le format standard est 16:9. Cette version prévoit 480p et 720p, tandis que le 1080p concerne la version 1.5.
L’animation de l’image source
Dans le mode de xAI avec une image, celle-ci devient la première image, et la consigne textuelle définit le mouvement. Par défaut, le format de la vidéo reprend les proportions de l’image source. Un rapport largeur/hauteur explicitement défini modifie ce format et peut étirer l’image.
La retouche ciblée
Lors du travail sur une vidéo existante, le modèle applique les modifications décrites en conservant le reste du contenu de la scène. Ce mode aide à modifier l’élément souhaité tout en conservant la mise en scène de la vidéo source. La durée et les proportions sont héritées de l’original ; aucune nouvelle durée ni forme d’image n’est définie.
La vidéo source de retouche est limitée à 8,7 secondes, et le résultat à une résolution ne dépassant pas 720p. Un contenu en 1080p est réduit à 720p. Les réglages de génération textuelle ne s’appliquent pas automatiquement à la retouche.
La prolongation d’une vidéo existante
Dans un mode distinct de xAI, cette version prolonge la vidéo source à partir de sa dernière image. Le MP4 source doit durer de 2 à 15 secondes ; la partie ajoutée, de 2 à 10 secondes, avec 6 par défaut. Le résultat réunit la vidéo source et sa prolongation. Les proportions et la résolution sont héritées de la source, avec une limite de 720p ; elles ne peuvent pas être modifiées séparément dans ce mode. Cette fonction du fabricant diffère de la génération textuelle publiée par Ailoot.
Les références et les limites de la version
xAI prévoit l’utilisation de références visuelles pour guider l’apparence des personnes, des vêtements et des objets dans la scène. Une référence définit les caractéristiques visuelles sans imposer une image précise comme premier photogramme. Avec Grok Imagine Video classique, il n’est pas possible de combiner une première image avec des références.
Cette version n’accepte pas la fixation exacte de la dernière image ni des images clés intermédiaires. Ces fonctions appartiennent à Grok Imagine Video 1.5. La génération, l’animation d’une image source et la modification d’une vidéo existante sont des modes distincts ; la méthode Ailoot publiée décrit ici la génération à partir de texte.
Ailoot · Vidéo POST /v1/videos/generations grok-imagine-video
grok-imagine-videoPremiers pas
Grok Imagine Video crée de courtes vidéos à partir d’une description textuelle, avec un choix de durée et de format. Le modèle de xAI lui-même prend aussi en charge l’animation d’images et la retouche ciblée de vidéos.
- 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 | 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 simultanément 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 | 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 est fournie en entrée et que le rapport est omis, le fournisseur reprend le rapport largeur/hauteur 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 spécifiés | Par défaut— |
Champimage | Typeobject | ExigenceFacultatif | Valeurs et limites Conditions: Image d’entrée réelle et prise en charge ; permet d’omettre la consigne | 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 identifiants sont exacts ; la capacité du fournisseur est distincte de l’admission.
Tarifs
Tarifs des méthodes Ailoot
POST /v1/videos/generations- Entrée
- 0.002 USD par image en entrée
- Entrée
- 0.01 USD par seconde de vidéo en entrée
- Sortie
- 0.05 USD par seconde en 480p
- Sortie
- 0.07 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", "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 dont vous êtes propriétaire. Conservez la durée indiquée et chaque champ de résultat renvoyé.
Si la réponse d’origine doit être vérifiée
Consultez la tâche d’origine existante ; ne répétez jamais un envoi dont l’issue est inconnue.
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 contenus ou valeur de paramètre non valides | É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 suivanteConsultez périodiquement l’identifiant d’origine renvoyé 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
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
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/videos/generations·grok-imagine-video:text→video- Quels champs la requête utilise-t-elle ?
POST /v1/videos/generations·grok-imagine-video:model,prompt,duration,seconds,resolution,aspect_ratio,size,image- Quelles limites s’appliquent ?
POST /v1/videos/generations·grok-imagine-video:duration.minimum:1;duration.maximum:15;seconds.minimum:1;seconds.maximum:15