Ratios, résolutions et gestion des coûts

Leçon corrigée le 3 novembre 2026 d’après la documentation vidéo de xAI : l’API accepte neuf ratios (dont 21:9 et 5:2) et trois définitions, le 1080p dépendant du modèle ; les trois modèles vidéo ont chacun leur tarif ; et le paramètre size, avec ses tailles en pixels, présenté par l’ancienne version ne figure pas dans la référence de l’API. Sources : Video Generation · Videos API · Tarifs.

Optimiser vos générations vidéo

Savoir écrire un prompt ne suffit pas à passer en production. Deux sujets décident du reste : le cadrage technique de vos sorties et la maîtrise de la facture. Un studio qui génère deux cents clips par mois sans stratégie de prototypage paie plusieurs fois le prix nécessaire, et une équipe qui découvre en fin de projet que son format ne correspond pas au support de diffusion recommence tout. Cette leçon traite ces deux points ensemble, parce qu’ils se répondent.

Choisir le bon ratio d’aspect

Le paramètre aspect_ratio fixe les proportions de la vidéo générée. Neuf valeurs sont acceptées, et chacune correspond à une destination de diffusion précise.

En l’absence de paramètre explicite, l’API applique 16:9. C’est un défaut raisonnable pour le web, mais il devient un piège dès que vous alimentez des formats verticaux : une campagne destinée aux Reels doit déclarer 9:16 sur chaque requête, sinon vous récupérerez des paysages qu’il faudra recadrer, avec la perte de composition que cela implique. Deux modes échappent à ce réglage : en image-to-video, la sortie suit le ratio de l’image source, et en édition celui de la vidéo source.

Trois définitions, selon le modèle

Le paramètre resolution accepte trois valeurs. La valeur par défaut, 480p, se destine aux prévisualisations et aux brouillons : le rendu est plus rapide, ce qui en fait un terrain d’essai idéal pour valider un prompt avant de le repasser en qualité finale. 720p correspond à une qualité HD suffisante pour la majorité des usages web et mobiles. 1080p, enfin, donne du Full HD, mais pas sur tous les modèles :

L’édition ne se règle pas : la vidéo produite garde la définition de la source, plafonnée à 720p. Et il n’existe pas de réglage plus fin que ces paliers : la référence de l’API ne prévoit aucun paramètre de taille en pixels. Si votre diffusion exige des dimensions exactes, choisissez le ratio et la définition les plus proches, puis recadrez au montage.

{
  "model": "grok-imagine-video-1.5",
  "prompt": "Votre description",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}

Ce que coûte réellement une production

Le prix se compte à la seconde de vidéo générée et dépend du modèle : $0.020 pour grok-imagine-video-1.5-lite, $0.050 pour grok-imagine-video et $0.080 pour grok-imagine-video-1.5. La progression est parfaitement linéaire, ce qui rend le budget prévisible.

Au 3 novembre 2026, la page Models de xAI affiche un seul prix par seconde pour chaque modèle, sans distinction de définition, alors que la page Video Overview renvoie à des prix « par résolution » : vérifiez la grille avant d’engager un gros lot.

Le premier levier d’optimisation est le choix du modèle. xAI recommande grok-imagine-video-1.5-lite, quatre fois moins cher que la version 1.5, pour les vidéos simples, et grok-imagine-video-1.5 quand il faut des images de référence, des voix, des images imposées ou du 1080p natif ; l’édition et l’extension, elles, ne fonctionnent qu’avec grok-imagine-video. Le second levier est le nombre d’essais. Prototypez systématiquement en court : validez la direction du mouvement sur deux ou trois secondes avant d’engager une génération de dix ou quinze. Travaillez le prompt jusqu’à ce qu’il soit juste du premier coup, puisque chaque régénération se paie plein tarif. Menez ces essais en 480p : le prix affiché ne change pas, mais le temps de génération raccourci vous fait itérer plus vite. Et gardez la limite de débit en tête au moment de planifier un lot.

Ce raisonnement se chiffre facilement. Pour un projet de vingt vidéos de cinq secondes avec grok-imagine-video, la production brute revient à 20 × $0.25, soit $5.00 ($2.00 avec la version lite, $8.00 avec la 1.5). Comptez deux itérations moyennes par vidéo et vous êtes à $10.00. Ajoutez une marge d’expérimentation de 50 % et vous présentez un budget de $15.00 qui tiendra. C’est cet ordre de grandeur qu’il faut communiquer à un client, pas le coût théorique du premier calcul.

Vivre avec les limites de débit

Les limites de l’API se comptent en requêtes par seconde, par modèle, et grandissent avec le palier de votre équipe, lui-même fixé par vos dépenses cumulées : au palier d’entrée, les modèles vidéo acceptent 10 requêtes par seconde, et l’API répond 429 Too Many Requests au-delà (Rate limits). En usage courant, cette limite est rarement atteinte : la génération étant asynchrone et longue, vous passez plus de temps à attendre qu’à soumettre. Le risque apparaît sur les lots massifs lancés en parallèle, où quelques lignes de code peuvent saturer le quota en un instant. Espacer les soumissions suffit à rester dans les clous.

import asyncio

async def soumettre_lot(prompts, par_seconde=5):
    """Soumet les générations sans dépasser la limite de débit."""
    for prompt in prompts:
        await soumettre_video(prompt)  # POST, sans attendre la fin
        await asyncio.sleep(1 / par_seconde)

Pour les très gros lots qui peuvent attendre, l’API Batch offre une autre voie : ses requêtes ne comptent pas dans les limites de débit, et les trois modèles vidéo l’acceptent (dans certaines régions seulement pour grok-imagine-video et grok-imagine-video-1.5). N’en attendez pas d’économie : la remise du Batch ne vaut que pour les modèles de texte, et la vidéo y est facturée au tarif standard. Le traitement se fait en général sous 24 heures, sans garantie.

Livrer la vidéo sans la récupérer

Dernier réglage utile en production : le paramètre output.upload_url désigne une URL signée (présignée S3 ou GCS, SAS Azure) vers laquelle la vidéo sera automatiquement envoyée par HTTP PUT, avec l’en-tête Content-Type: video/mp4, dès qu’elle est générée.

{
  "model": "grok-imagine-video",
  "prompt": "Votre description",
  "duration": 5,
  "output": {
    "upload_url": "https://votre-stockage.com/upload/video.mp4"
  }
}

Concrètement, cela supprime toute une étape de votre pipeline : plus besoin de télécharger chaque fichier puis de le repousser vers votre stockage, la vidéo arrive directement à destination. Sur un flux de plusieurs dizaines de clips par jour, c’est autant de code de transfert et de gestion d’erreurs en moins à maintenir.

Tarifs relevés le 3 novembre 2026 — les prix évoluent régulièrement : avant tout calcul de budget, vérifiez la grille en vigueur sur la page officielle des modèles et tarifs xAI.

Points clés à retenir

• Neuf ratios d’aspect sont disponibles, 16:9 par défaut ; en image-to-video, la sortie suit le ratio de l’image
• Trois définitions : 480p (défaut), 720p et 1080p, ce dernier sur les modèles 1.5 seulement
• Aucun paramètre ne fixe une taille en pixels : le ratio et la définition suffisent
• Le prix est linéaire, à la seconde : $0.020, $0.050 ou $0.080 selon le modèle
• Prototypez court, en 480p, avec le modèle le moins cher qui suffit
• output.upload_url automatise la livraison ; l’API Batch échappe aux limites de débit, sans remise sur la vidéo