SpaceXAI: Grok Imagine Video 1.5 Lite
Grok Imagine Video 1.5 Lite génère de courts clips avec du son à partir d’une scène écrite ou d’une image de départ. Il prend en charge des sorties de 1 à 15 secondes, les cadrages paysage et portrait et la parole avec synchronisation labiale. Choisissez directement la 480p ou la 720p, ou une sortie 1080p obtenue par agrandissement de la 720p ; les contrôles avancés de références et d’images clés appartiennent à la version 1.5 complète.
À 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.
Grok Imagine Video 1.5 Lite est l’édition de génération simplifiée de la famille vidéo Grok Imagine. Le producteur la recommande pour les tâches simples de génération de vidéo à partir de texte ou d’images. Une scène écrite peut devenir un court clip, ou une image fixe fournie peut servir d’image d’ouverture à un plan animé. La sortie comprend du son généré, et cette édition prend en charge la parole avec synchronisation labiale. Les livrables utiles incluent un bref mouvement de produit, un plan d’ensemble d’ambiance ou un court moment où un personnage parle.
Pour la génération de vidéo à partir de texte, décrivez ce qui est visible, ce qui se passe pendant le plan et la manière dont la caméra doit l’observer. Précisez l’éclairage, le rythme et les sons pertinents. Le producteur explique que Lite crée d’abord une image à partir du prompt, puis l’anime ; cette image fixe intermédiaire n’est pas renvoyée comme fichier distinct. Pour préparer le travail, donnez au court clip un événement clair et suffisamment de place pour qu’il se déroule. Un vaste décor extérieur, un détail de produit en gros plan et un portrait parlé demandent des consignes de composition et de mouvement différentes.
Par exemple, un brief peut demander un lent rapprochement vers une tasse en céramique sur une table de petit-déjeuner calme pendant que de la vapeur s’élève, avec une lumière matinale douce et une ambiance sonore discrète dans la pièce. Vérifiez surtout que la tasse reste reconnaissable, que la vapeur se déplace naturellement et que la caméra suit la direction prévue. Gardez le mouvement de cet exemple simple pour évaluer le plan. Si un personnage parle, indiquez la réplique souhaitée et une brève description de son interprétation, puis vérifiez les mots et le mouvement visible de la bouche dans le résultat.
Pour la génération de vidéo à partir d’une image, celle-ci définit la première image du clip et le prompt décrit la suite. Choisissez une image fixe de départ où le sujet, le cadrage et les détails visuels souhaités sont déjà en place. Donnez des consignes de mouvement compatibles avec cette composition, par exemple un léger mouvement de tête, un mouvement de caméra doux ou du vent dans un tissu. La sortie suit le rapport largeur/hauteur de l’image ; le réglage distinct de rapport largeur/hauteur est ignoré dans ce mode. Préparez à l’avance un recadrage portrait si le clip final doit être vertical.
La durée de sortie documentée va de 1 à 15 secondes, avec huit secondes par défaut. La génération à partir de texte propose des compositions carrées, paysage, portrait et plus larges, notamment 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 et 5:2. Déterminez l’usage du plan avant de choisir son cadrage. Un clip portrait pour les réseaux sociaux peut nécessiter de la place pour ajouter des légendes, tandis qu’un insert paysage peut demander de l’espace autour du sujet pour faciliter le montage. Adaptez l’action demandée à la durée du clip plutôt que de comprimer une longue séquence dans un bref plan.
Lite propose des sorties 480p et 720p, ainsi qu’une option 1080p obtenue par agrandissement de la 720p. Cette distinction compte pour les contenus sensibles aux détails : une image de sortie plus grande ne signifie pas que cette édition calcule la scène nativement en 1080p. Vérifiez les petites inscriptions, les contours des produits et les visages aux dimensions de diffusion prévues. Les vidéos générées comprennent du son par défaut, et la configuration de génération du producteur permet aussi un résultat muet. Précisez l’intention sonore avec autant de soin que l’action visible si le clip doit être utilisé avec sa piste générée.
Dans l’interface documentée du producteur, la génération est asynchrone. Un identifiant de requête permet de suivre le travail en cours ; une réponse terminée fournit l’adresse de la vidéo et sa durée. L’exemple de résultat terminé dans le guide pointe vers un clip MP4 et explique que les adresses de sortie sont temporaires. Conservez le fichier terminé lorsque vous préparez un montage, avec le prompt, l’image source et les réglages choisis. Une tâche envoyée reste une étape de traitement ; le résultat de production utile est le clip lisible qui contient les images et le son demandés.
Le choix de l’édition dépend des contrôles nécessaires au plan. La version complète de Grok Imagine Video 1.5 ajoute les références à plusieurs images, les références vocales sélectionnées, les premières ou dernières images exactes et les images intermédiaires imposées, et génère nativement en 1080p les vidéos issues de texte ou d’images. Lite se concentre sur un prompt ou une seule image de départ. L’édition classique de Grok Imagine Video fournit les fonctions de modification et de prolongement vidéo. Ces distinctions permettent de choisir un modèle adapté aux matériaux déjà disponibles, plutôt que de considérer tous les membres de la famille comme un même générateur.
Vérifiez le plan terminé pour la continuité du sujet, la vraisemblance du mouvement, le cadrage et le son demandé. En présence de dialogue, examinez les mots et leur synchronisation avec le personnage. Pour préparer plusieurs clips d’une séquence, conservez dans chaque brief la description pertinente du sujet ou le visuel de départ, puis évaluez les raccords au montage. Un court plan bien défini est plus facile à diagnostiquer : la revue peut déterminer si la prochaine modification doit porter sur l’image source, l’action, la caméra ou la réplique.
Ailoot Ultra · Vidéo POST /v1/videos x-ai/grok-imagine-video-1.5-lite
x-ai/grok-imagine-video-1.5-lite
x-ai/grok-imagine-video-1.5-litePremiers pas
Grok Imagine Video 1.5 Lite génère de courts clips avec du son à partir d’une scène écrite ou d’une image de départ. Il prend en charge des sorties de 1 à 15 secondes, les cadrages paysage et portrait et la parole avec synchronisation labiale. Choisissez directement la 480p ou la 720p, ou une sortie 1080p obtenue par agrandissement de la 720p ; les contrôles avancés de références et d’images clés appartiennent à la version 1.5 complète.
- Entrées acceptées
- Texte · Images
- Résultats
- Vidéo
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Vidéo POST /v1/videos
- Entrée
text,image- Sortie
video- Format de sortie
- Octets MP4 d’origine ; sans normalisation ni transcodage
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites x-ai/grok-imagine-video-1.5-lite | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champduration | Typeinteger | ExigenceObligatoire | Valeurs et limites 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Par défaut— |
Champresolution | Typestring | ExigenceFacultatif | Valeurs et limites 480p, 720p, 1080p | Par défaut— |
Champaspect_ratio | Typestring | ExigenceFacultatif | Valeurs et limites 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 | Par défaut— |
Champgenerate_audio | Typeboolean | ExigenceFacultatif | Valeurs et limites false | Par défaut— |
Champframe_images | Typearray | ExigenceFacultatif | Valeurs et limites Nombre minimal d’éléments: 1 Nombre maximal d’éléments: 1 Contenu en entrée: Tableau d’objets d’image. Chaque objet contient type=image_url, image_url contenant url et frame_type. Utilisez une URL d’image HTTPS et définissez frame_type sur first_frame. Chaque rôle d’image apparaît au maximum une fois. Clés exactes: type, image_url, frame_type Conditions: Ces clés décrivent chaque objet d’image ; image_url contient uniquement url. Omettez frame_images pour une requête contenant uniquement du texte. | Par défaut— |
Champinput_references | Typearray | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champcallback_url | Typestring | ExigenceFacultatif | Valeurs et limites Motif: ^https:// | Par défaut— |
Champsession_id | Typestring | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champtrace | Typeobject | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champuser | Typestring | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Combinaisons d’éléments d’entrée
Texte vers vidéo · Une consigne écrite. · Obligatoire : model, prompt, duration
Fournissez la consigne sous forme de texte et la durée en secondes entières. Choisissez une résolution prise en charge et, si nécessaire, un rapport largeur/hauteur.
model: Type : string · x-ai/grok-imagine-video-1.5-lite
prompt: Type : string · Nombre maximal d’octets UTF-8: 10'000 · Caractères autres que des espaces requis: Oui
Image vers vidéo · Une consigne écrite et une image de départ. · Obligatoire : model, prompt, duration, frame_images
frame_images est un tableau. Chaque objet d’image comprend type, image_url et frame_type ; image_url contient url. Définissez type sur image_url. Utilisez first_frame. Chaque rôle d’image apparaît au maximum une fois. Fournissez une URL d’image HTTPS publique pour chaque image. Choisissez une résolution prise en charge et, si nécessaire, un rapport largeur/hauteur.
Clés exactes : type, image_url, frame_type
model: Type : string · x-ai/grok-imagine-video-1.5-lite
prompt: Type : string · Nombre maximal d’octets UTF-8: 10'000 · Caractères autres que des espaces requis: Oui
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt, duration |
Paramètrematerial_types | Contrattext, image |
Paramètreadditional_properties | Contratfalse |
Paramètreoptional_controls | Contratresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user |
Cycle de vie : submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Tarifs
Calcul du coût final
Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
- Mode rapide
- Non précisé Lorsque le mode rapide est sélectionné
- Mode Flex
- Non précisé Lorsque le mode flex est sélectionné
- Effort de raisonnement maximal
- Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)
Tarifs estimés à des fins de comparaison
Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Quantité prévisionnelle | Unité de facturation | Conditions de facturation | Coût |
|---|---|---|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Quantité prévisionnelle— | Unité de facturation— | Conditions de facturation— | Coût Entrée · Tokens en entrée · Estimation à des fins de comparaison uniquement — / 1K tokens Sortie · Tokens en sortie · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K tokens |
| ConfigurationImage en entrée | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar image | Conditions de facturationCette clé de tarification ne déclare aucune condition supplémentaire. | Coût Entrée · Image en entrée · Estimation à des fins de comparaison uniquement $0.02 par image |
| ConfigurationTarif vidéo | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar seconde de vidéo | Conditions de facturationresolution: 1080p | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.28 par seconde de vidéo |
| ConfigurationTarif vidéo | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar seconde de vidéo | Conditions de facturationresolution: 480p | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.04 par seconde de vidéo |
| ConfigurationTarif vidéo | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar seconde de vidéo | Conditions de facturationresolution: 720p | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.06 par seconde de vidéo |
| ConfigurationCoût estimé de la génération | Barème tarifaire— | Quantité prévisionnelleEstimation pour une génération | Unité de facturation— | Conditions de facturation— | Coût Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.04 estimation avant génération Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée. |
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 →
Détails du tarif de référence
Les barèmes de référence du modèle ne modifient ni la sélection de méthode, ni les devis, ni les coûts. Les frais actifs utilisent les tarifs de la méthode Ailoot sélectionnée.
Références tarifaires des configurations vidéo
Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Conditions de facturation | Coût |
|---|---|---|
| ConfigurationImage en entrée | Conditions de facturationCette clé de tarification ne déclare aucune condition supplémentaire. | Coût Entrée · Image en entrée $0.02 par image Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée. |
| ConfigurationTarif vidéo | Conditions de facturationresolution: 480p | Coût Sortie · Tarif vidéo $0.04 par seconde de vidéo Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée. |
| ConfigurationTarif vidéo | Conditions de facturationresolution: 720p | Coût Sortie · Tarif vidéo $0.06 par seconde de vidéo Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée. |
| ConfigurationTarif vidéo | Conditions de facturationresolution: 1080p | Coût Sortie · Tarif vidéo $0.28 par seconde de vidéo Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée. |
Exemples de requêtes
Ailoot Ultra · Vidéo
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"x-ai/grok-imagine-video-1.5-lite","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Recevoir et enregistrer les résultats
Ailoot Ultra · Vidéo
liens de contenu signés dont vous êtes propriétaire
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Vérifier l’état de la tâche
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Autres lectures de contenu
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
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')
target=Path('owned-'+label+'.bin')
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)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Conserver 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 chaque résultat réel dont vous êtes propriétaire et les métadonnées mesurées renvoyées avec celui-ci.
Si la réponse d’origine doit être vérifiée
503 result_pending_check + identifiant d’origine + X-Should-Retry:false ; ne répétez jamais l’envoi d’origine
Champs de la réponse
| Champ | Type | Signification |
|---|---|---|
Champindex | Typeinteger | SignificationPosition de cette vidéo dans la liste des résultats, avec une indexation à partir de zéro. |
Champcontent_url | Typestring | SignificationURL HTTPS signée de téléchargement de cette vidéo terminée. |
Champsha256 | Typestring | null | SignificationEmpreinte SHA-256 des octets vidéo d’origine ; null si elle est indisponible. |
Champsize_bytes | Typeinteger | null | SignificationTaille du fichier vidéo d’origine en octets ; null si elle est indisponible. |
Champduration_ms | Typeinteger | null | SignificationDurée mesurée de la vidéo en millisecondes ; null si elle est indisponible. |
Champwidth | Typeinteger | null | SignificationLargeur de la vidéo en pixels ; null si elle est indisponible. |
Champheight | Typeinteger | null | SignificationHauteur de la vidéo en pixels ; null si elle est indisponible. |
Champvideo_codec | Typestring | null | SignificationIdentifiant du codec vidéo ; null s’il n’a pas été enregistré. |
Champhas_audio | Typeboolean | null | SignificationIndique si la vidéo contient une piste audio ; null si cela n’a pas été mesuré. |
Champaudio_codec | Typestring | null | SignificationIdentifiant du codec audio ; null si aucun identifiant n’a été enregistré. |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse404 · not_found_error | ConditionL’accès à la vidéo est indisponible, ou cet identifiant vidéo est introuvable. | Étape suivanteVérifiez l’accès à la vidéo. Pour une vidéo existante, utilisez son identifiant public d’origine et la même clé API. |
Réponse401 · authentication_error | ConditionLa clé API ne correspond pas au compte authentifié. | Étape suivanteVérifiez votre clé API et l’accès au compte avant l’envoi. |
Réponse400 · invalid_request_error | ConditionLa requête n’a pas pu être lue, ou l’indice de téléchargement est invalide. | Étape suivanteCorrigez le corps de la requête. Pour un téléchargement, choisissez un indice de sortie renvoyé par la tâche d’origine. |
Réponse422 · price_unavailable | ConditionLa configuration vidéo sélectionnée ne peut pas être tarifée. | Étape suivanteChoisissez une configuration vidéo prise en charge et renseignez toutes ses options obligatoires avant d’envoyer une demande corrigée. |
Réponse422 · invalid_request_error | ConditionUne entrée vidéo ou une tâche d’origine à prolonger est invalide. | Étape suivanteUtilisez des entrées HTTPS valides. Pour une prolongation, utilisez l’identifiant vidéo public de votre vidéo d’origine terminée avec la même clé API. |
Réponse402 · billing_error | ConditionLe solde disponible ou les limites ne permettent pas de réserver le montant. | Étape suivanteVérifiez votre solde disponible et vos limites avant d’envoyer une nouvelle demande. |
Réponse503 · server_error | ConditionLa vérification vidéo, le stockage ou l’accès au service est temporairement indisponible. | Étape suivanteAttendez que le service soit disponible. Si vous avez déjà un identifiant vidéo, vérifiez cette tâche d’origine au lieu de lancer une nouvelle génération. |
Réponse503 · result_pending_check | ConditionLe résultat vidéo d’origine et sa facturation doivent être vérifiés. | Étape suivanteConservez l’identifiant vidéo renvoyé et vérifiez cette tâche. N’envoyez pas de demande de génération de remplacement pendant sa vérification. |
Réponse503 · owned_result_unavailable | ConditionLe téléchargement de la vidéo existante est temporairement indisponible. | Étape suivanteVérifiez ultérieurement cette même tâche vidéo et téléchargez son résultat existant. Une nouvelle génération crée une opération distincte. |
Réponse409 · video_not_ready | ConditionLe contenu vidéo n’a pas été publié. | Étape suivanteVérifiez l’état de la tâche d’origine. Téléchargez le résultat lorsqu’elle indique completed ; si elle indique failed, suivez son avis de vérification de facturation. |
Alias
Alias du modèle
Ailoot Ultra x-ai/grok-imagine-video-1.5-lite
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · SpaceXAI: Grok Imagine Video 1.5 Lite
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/videos·x-ai/grok-imagine-video-1.5-lite:text,image→video- Quels champs la requête utilise-t-elle ?
POST /v1/videos·x-ai/grok-imagine-video-1.5-lite:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,callback_url,session_id,trace,user- Quelles limites s’appliquent ?
POST /v1/videos·x-ai/grok-imagine-video-1.5-lite:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1