Tarification de l’API Luma : documentation de Ray 3.2 et coût par clip

Un clip unique de 5 secondes en 720p généré avec Ray 3.2 coûte 0,30 $ sur l’API Luma. Passez le même clip en 1080p et le prix grimpe à 1,20 $. Ajoutez un export HDR et EXR en 1080p, et un plan de cinq secondes revient à 3,60 $. Ces chiffres viennent directement de la page Pricing de Luma, et ils déterminent si un projet de 200 clips coûte le prix d’un déjeuner ou celui d’un ordinateur portable. Cet article détaille chaque tarif de Ray 3.2, parcourt la documentation de l’API pour vous permettre d’envoyer une première requête, signale les combinaisons de paramètres que l’API rejette et montre comment garder une facture légère. Si vous préférez éviter le code, une section explique comment utiliser Ray 3.2 sur PicassoIA depuis un navigateur.

💡 Luma indique que les tarifs vidéo sont susceptibles d’évoluer avant la disponibilité générale. Vérifiez à nouveau la page Pricing sur docs.agents.lumalabs.ai avant de fixer un budget.

Tarification de l’API Ray 3.2 en un coup d’œil

Luma facture Ray 3.2 en fonction de la durée du clip et de la qualité de sortie, et non au nombre de tokens. Chaque génération tient dans un bloc fixe de 5 secondes ou de 10 secondes, et le prix augmente avec la résolution et la plage dynamique. La génération texte vers vidéo et la génération image vers vidéo partagent la même grille tarifaire : un clip animé à partir d’une photo coûte donc le même prix qu’un clip écrit à partir d’un prompt.

Tarifs en plage dynamique standard

La plage dynamique standard (SDR) est la sortie par défaut, et c’est le tarif que paie la plupart des projets.

Le passage du 720p au 1080p mérite un second regard. Une image en 1080p contient 2,25 fois le nombre de pixels d’une image en 720p, pourtant le prix est multiplié par 4. À moins que la destination affiche réellement le 1080p, le niveau le moins cher reste le meilleur choix par défaut.

Tarifs d’export HDR et EXR

Le HDR est limité aux clips de 5 secondes en 720p ou 1080p. L’export EXR, le fichier couleur brut destiné à l’étalonnage professionnel, s’ajoute au HDR.

Le HDR double le prix du SDR, et ajouter l’EXR le triple. Si le clip est destiné à Instagram ou à une page de destination, rien dans la chaîne de visionnage ne fera apparaître cette plage supplémentaire : renoncez au HDR et à l’EXR et économisez les deux tiers du prix.

Tarifs de recadrage et d’extension

Deux autres opérations ont leurs propres tarifs, tous deux uniquement en plage dynamique standard.

• Recadrage (modifier le format d’une vidéo existante) est facturé à la seconde : 0,03 $ en 360p, 0,06 $ en 540p, 0,12 $ en 720p et 0,36 $ en 1080p.
• Extension à partir d’une seule image d’ancrage est facturée comme un bloc de 5 secondes : 0,15 $ en 540p, 0,30 $ en 720p et 1,20 $ en 1080p.
• Montage vidéo dispose de tarifs distincts en SDR, HDR et HDR + EXR, avec des paliers de 5 et 10 secondes, tous plus élevés que la génération simple. Consultez les chiffres exacts du montage sur la page Pricing.

Voici un chiffre à retenir. Recadrer un clip de 5 secondes en 720p coûte 5 × 0,12 $ = 0,60 $. Générer directement un nouveau clip en 9:16 coûte 0,30 $. Si vous n’avez besoin que de la version verticale et non du plan d’origine exact, générez-la directement au bon format dès le départ.

Le coût réel d’un clip

Coût par seconde selon le palier

Diviser chaque bloc par sa durée donne un chiffre plus facile à comparer avec d’autres outils vidéo.

Une minute de séquence finie, construite à partir de douze clips de 5 secondes, coûte 3,60 $ en 720p et 14,40 $ en 1080p. Cela suppose que vous gardiez chaque prise, ce que personne ne fait.

Deux clips de 5 secondes battent un clip de 10

Un clip de 10 secondes en 720p coûte 0,90 $. Deux clips de 5 secondes coûtent 0,60 $. Le bloc le plus long revient donc 50 % plus cher à la seconde, et la même logique vaut pour chaque résolution. En 1080p, l’écart est de 3,60 $ contre 2,40 $.

L’option de 10 secondes comporte aussi des restrictions. L’API rejette 10s combiné au HDR, à une image de début, à une image de fin ou à la boucle. La voie la moins chère est donc souvent aussi la plus souple. Générez le premier clip, récupérez sa dernière image et transmettez-la comme image de début du second clip pour que le mouvement se poursuive sans saut visible.

Exemples de budgets

Ajoutez maintenant la part que la plupart des budgets oublient. Si vous gardez une prise sur trois, multipliez par trois. La chaîne hebdomadaire avec 100 clips retenus devient 300 générations, soit 90 $ au lieu de 30 $.

Intégrez ce multiplicateur à chaque estimation que vous envoyez à un client. Un prix forfaitaire par clip paraît bon marché jusqu’à ce qu’un réalisateur demande la quatrième variante du même plan. Suivez les clips acceptés par rapport aux clips générés pendant la première semaine, et vous obtiendrez un taux de nouvelles tentatives réel. Ce seul chiffre rendra toutes les prévisions suivantes plus fiables.

Parcours de la documentation de l’API Ray 3.2

Luma publie Ray 3.2 à travers sa documentation de l’API Agents. Trois éléments comptent avant votre premier appel : l’URL de base, l’en-tête d’authentification et la structure de la requête.

URL de base et authentification

L’URL de base est https://agents.lumalabs.ai/v1. L’authentification utilise un jeton bearer dans l’en-tête Authorization. Stockez le jeton dans une variable d’environnement et ne le versionnez jamais dans un dépôt. Des SDK officiels existent pour Python et TypeScript (tous deux nommés luma-agents) et pour Go (luma-agents-go), ainsi qu’un outil en ligne de commande.

La requête de génération

Tout commence par POST /v1/generations. Trois champs sont obligatoires :

• model : défini sur "ray-3.2"
• type : défini sur "video"
• prompt : de 1 à 6 000 caractères décrivant le sujet, le mouvement, le mouvement de caméra, l’éclairage et le rythme

Des champs facultatifs affinent la sortie. aspect_ratio accepte 9:16, 3:4, 1:1, 4:3, 16:9 ou 21:9. L’objet video prend resolution (360p, 540p, 720p par défaut, ou 1080p), duration ("5s" par défaut ou "10s"), ainsi que hdr et loop en booléens.

curl https://agents.lumalabs.ai/v1/generations \
  -H "Authorization: Bearer $LUMA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ray-3.2",
    "type": "video",
    "prompt": "Slow dolly shot through a misty greenhouse at sunrise",
    "aspect_ratio": "16:9",
    "video": { "resolution": "720p", "duration": "5s" }
  }'

Copier le prompt

Cette requête est facturée 0,30 $ : 720p, 5 secondes, plage dynamique standard.

Interroger l’état de la tâche

Une soumission réussie renvoie le code HTTP 201 avec l’état queued. Interrogez GET /v1/generations/{id} jusqu’à ce que la tâche atteigne un état final, soit réussi, soit failed. En cas de succès, la sortie inclut une URL présignée vers le fichier MP4. Les liens présignés sont temporaires par conception : copiez donc le fichier dans votre propre stockage immédiatement.

Prévoyez environ 80 à 200 secondes par clip. Les exemples exécutés sur la page Ray 3.2 de PicassoIA ont pris entre 79 et 204 secondes, interroger toutes les 5 à 10 secondes suffit donc largement.

Règles de paramètres qui déclenchent des erreurs

Une requête rejetée fait perdre un aller-retour, et une règle mal comprise fait perdre un après-midi. La documentation de Luma précise quelles options ne peuvent pas être combinées.

Conflits HDR, boucle et 10 s

Validez ces règles dans votre propre code avant d’appeler l’API. Une petite fonction qui vérifie la combinaison demande dix minutes à écrire et supprime toute une catégorie de tâches en échec.

Limites de débit et erreurs 429

Deux limites indépendantes s’appliquent à POST /v1/generations :

1. Requêtes par minute (RPM) : le nombre maximal de requêtes dans une fenêtre glissante de 60 secondes.
2. Tâches simultanées : le nombre maximal de générations actives à un instant donné.

Luma ne publie pas de chiffres exacts. Vos limites dépendent de votre forfait et apparaissent dans le tableau de bord de la plateforme Luma. Les deux limites renvoient HTTP 429, et le corps de la réponse permet de les distinguer.

Dimensionnez un sémaphore dans votre worker à la limite de simultanéité affichée sur votre tableau de bord, et respectez Retry-After au lieu de relancer selon un minuteur fixe. Répartissez un gros lot sur la minute au lieu d’envoyer toutes les requêtes d’un coup, et la fenêtre RPM ne posera plus de problème.

Comment garder la facture basse

Brouillon en 360p d’abord

Le palier brouillon en 360p coûte 0,06 $, soit un cinquième d’un clip en 720p et un vingtième d’un clip en 1080p. Testez chaque prompt à ce niveau, puis ne passez en définition supérieure que les meilleurs.

Prenez 25 plans dont vous avez besoin en 1080p. Générer les 25 directement en 1080p coûte 30,00 $. Générer 20 brouillons (1,20 $) et passer 5 gagnants en 1080p (6,00 $) coûte 7,20 $, soit une économie de 76 %.

Une mise en garde : un brouillon est une génération distincte. Considérez-le comme un test du prompt et de l’idée de mouvement, et non comme un aperçu exact au pixel près. Vérifiez qu’une nouvelle génération conserve le même plan avant de bâtir un flux de travail autour de cette méthode.

💡 Fixez une limite stricte de relances dans votre worker : trois tentatives, puis arrêt et journalisation du prompt. Une boucle qui renvoie la requête à chaque échec transforme une erreur de 0,30 $ en une vraie facture.

Adapter la résolution à la destination

Définissez aspect_ratio au moment de la génération plutôt que de recadrer ensuite, et utilisez l’indicateur loop pour les clips d’arrière-plan plutôt que d’assembler une boucle à la main.

Ray 3.2 sans écrire de code

L’API convient à un produit ou à un pipeline programmé. Pour un projet ponctuel, une interface dans le navigateur supprime la gestion du jeton, la boucle d’interrogation et le code de limitation de débit. PicassoIA héberge Ray 3.2 : vous choisissez les réglages dans un formulaire et téléchargez le MP4.

PicassoIA propose aussi sa propre API, sur le modèle de Replicate. Au moment de la rédaction, elle expose quatre modèles PicassoIA, dont PicassoIA Video et Seedance 2.5 Lite. Ray 3.2 ne figure pas dans cette liste : il reste donc dans l’interface web.

Ce que PicassoIA vous offre

Les mêmes règles de combinaison que celles de l’API de Luma s’appliquent. Une différence : le formulaire PicassoIA ne liste pas le palier brouillon en 360p. Vérifiez votre forfait sur PicassoIA pour savoir comment les générations Ray 3.2 sont comptabilisées.

Utiliser Ray 3.2 sur PicassoIA

1. Ouvrez la page du modèle Ray 3.2.
2. Rédigez un prompt qui précise le sujet, le mouvement, le mouvement de caméra, l’éclairage et le rythme.
3. Commencez en 720p et 5 secondes pendant vos tests.
4. Choisissez un format, ou importez une image de début pour animer une photo.
5. Activez le HDR ou la boucle uniquement si les règles ci-dessus le permettent.
6. Générez, examinez le clip, ajustez le prompt et relancez. Une fois le mouvement satisfaisant, générez de nouveau en 1080p.

Un prompt qui fonctionne bien sur la page du modèle : « Lent travelling cinématographique à travers une serre brumeuse au lever du soleil, rayons de soleil dorés filtrant à travers la condensation sur des panneaux de verre ancien, fougères et orchidées luxuriantes, reflets d’objectif anamorphique. »

Alternatives moins chères et gratuites

Ray 3.2 n’est pas le seul moyen d’obtenir un mouvement cinématographique, et à 1,20 $ par plan en 1080p, ce n’est pas toujours le moins cher. Ces modèles PicassoIA réalisent les mêmes tâches de texte vers vidéo et d’image vers vidéo :

Une répartition pratique : prototypez sur un modèle gratuit, puis dépensez vos crédits Ray 3.2 pour les plans qui ont besoin du HDR, de l’EXR ou du format 21:9. PicassoIA référence aussi les catégories d’upscaling vidéo et de super-résolution sur sa page de tous les modèles. Il vaut la peine de tester si un clip Ray 3.2 en 720p, une fois upscalé, atteint votre niveau de qualité avant de payer le tarif 4× du 1080p natif.

Générez votre premier clip dès aujourd’hui

Les chiffres sont simples une fois mis côte à côte. Le 720p coûte 0,30 $, le 1080p coûte 1,20 $, le HDR double le prix, l’EXR le triple, et deux clips de 5 secondes battent un clip de 10 secondes. Faites un brouillon en 360p, générez au format dont vous avez besoin et plafonnez vos relances.

Ouvrez Ray 3.2 sur PicassoIA, lancez un prompt en 720p, puis soumettez exactement le même prompt à Ray Flash 2 720p et à Seedance 2.5 Lite. Trois clips côte à côte vous en apprendront plus sur le rapport prix et qualité que n’importe quelle grille tarifaire. Créez le vôtre dès maintenant sur picassoia.com.