Skip to main content
POST /videos/generations produit une vidéo dans l’un des trois modes, sélectionné par le champ mode :
  • image_to_video — anime une frame de départ, avec une frame de fin optionnelle sur les engines qui la prennent en charge.
  • text_to_video — génère un clip à partir d’un prompt seul.
  • text_to_video_styled — un prompt plus les modèles entraînés de ton organisation.
Les capacités des engines (modes pris en charge, durées, résolutions, ratios d’aspect, prise en charge de la frame de fin et de l’audio, et tarification) proviennent de GET /videos/models — lis-le d’abord pour choisir une combinaison engine + duration valide.

Modèle asynchrone

POST /videos/generations renvoie 202 Accepted avec un id de job ; interroge GET /videos/generations/{id} jusqu’à completed, puis lis la vidéo produite (presigned URL valable 24 heures). Un webhook_url te donne un callback push — voir Webhooks.

Credits

Les credits vidéo dépendent du tarif par seconde de l’engine, de la durée, du multiplicateur de résolution et du multiplicateur audio — voir credits_per_second et les multiplicateurs dans GET /videos/models. Les coûts puisent dans le pool de ton organisation ; un pool épuisé renvoie 402. Voir Tarifs.