Cas d’utilisation de l’API Reframe

Dernière mise à jour le 22 sept. 2026

Découvrez l’API Reframe et les cas d’utilisation auxquels elle convient le mieux.

L’API Reframe modifie le rapport L/H d’une vidéo en suivant intelligemment la partie la plus importante de chaque plan et en recomposant le cadrage autour de celle-ci. Tout le contenu de la sortie recadrée est dérivé uniquement de la vidéo source, et l’API ne génère jamais de nouveaux pixels pour combler l’espace.

Meilleurs cas d’utilisation

L’API Reframe fonctionne de manière fiable sur :

  • Les vidéos nécessitant des rapports L/H standard pour les réseaux sociaux : la conversion de vidéos avec un rapport L/H 16:9 vers les formats 9:16, 1:1, 4:3 et 4:5 pour différents canaux constitue le cas d’utilisation principal. Vous pouvez également spécifier une résolution de sortie exacte (par exemple, 1920×1080) pour une diffusion parfaite au pixel près. 
  • Les prises de vues réelles et les séquences filmées : les interviews, les présentations de produits, le contenu lifestyle, les événements et autres vidéos capturées par caméra sont recadrés proprement. Le mouvement naturel de la caméra est automatiquement lissé, sans aucun artefact visible. 
  • Les plans présentant un sujet dominant : le sujet dominant, comme une personne, un produit ou un point focal, reste dans le cadre tout au long de la recomposition. Avec Semantic Subject Lock, vous pouvez désigner le sujet à suivre en utilisant un mot-clé ou un prompt (par exemple, homme en veste jaune ou frisbee) et l’API Reframe le suivra dans chaque plan. 
  • Les vidéos composées de plusieurs plans avec des coupes nettes : lorsque la détection de changement de scène est activée, l’API analyse chaque transition et maintient une composition stable dans chaque plan, quel que soit le rapport L/H de sortie. 
  • Les vidéos nécessitant des recouvrements cohérents : les recouvrements pré-générés (PNG ou GIF) peuvent être appliqués avec un contrôle du minutage, de la position, de l’échelle et de la répétition, tout en restant alignés dans tous les rapports L/H que vous générez.

Cas d’utilisation inadaptés

Parce que l’API Reframe ne fait que repositionner et recadrer dans les pixels existants, elle ne génère jamais de nouveau contenu pour combler l’espace. Les types de contenu suivants risquent d’être dégradés lors du recadrage ou il échouera :

  • Texte plein écran et incrustations en bas d’écran : les titres, légendes, crédits et graphiques intégrés dans la vidéo source occupent toute la largeur du rapport L/H original. Lorsque la vidéo est recadrée vers un rapport plus étroit, comme 16:9 vers 9:16, l’API Reframe tronque le texte sur les bords car elle ne peut pas refluer le contenu intégré. Elle peut seulement déplacer la fenêtre de recadrage. Pour les vidéos avec du texte et des graphiques, recadrez d’abord les vidéos propres, puis utilisez DGR (avec des MOGRT de tailles différentes) pour superposer le texte dessus.
  • Scènes multi-sujets avec action simultanée : Semantic Subject Lock ne peut suivre qu’un seul sujet tout au long de la recomposition. Lorsque deux sujets ou plus sont également importants et spatialement séparés, comme une interview entre deux personnes en plan large, un panel, ou un jeu sportif avec un ballon et un joueur éloigné, le recadrage ne peut maintenir qu’un seul sujet. Les autres se trouvent hors du cadre.
  • Changements de scène rapides ou ambigus : la détection de changement de scène préserve la cohérence de la composition lors des transitions, mais des coupes très rapides, des transitions par flash ou certains raccords peuvent amener le système de suivi à verrouiller le mauvais élément, provoquant des sauts dans le cadrage. 
  • Contenu graphique à composition fixe : Les enregistrements d’écran, les présentations, les tableaux de bord et les enregistrements avec de nombreuses animations graphiques n’ont aucun sujet suivable et aucune zone de recadrage sûre. L’API Reframe traite chaque pixel de ce contenu comme important ; ce type de contenu ne doit donc pas être envoyé à l’API.
  • Animation et motion graphics : le contenu animé, tel que les constructions de logos, la typographie cinétique, les séquences de titres et les animations de marque, ne se recadre pas de manière fiable. Ce type de contenu présente souvent des bords graphiques nets et des éléments en mouvement rapide qui nécessitent un cadrage précis, image par image, et combine fréquemment plusieurs éléments se déplaçant dans différentes directions à la fois. L’API Reframe est optimisée pour les enregistrements du monde réel et ne peut pas suivre les éléments animés avec suffisamment de précision ; ainsi, le résultat peut sembler légèrement décalé ou accuser un décalage par rapport au mouvement. Pour l’animation, générez le rendu de chaque rapport L/H à partir de la source d’animation originale, ou de son MOGRT via DGR, plutôt que de recadrer un export fini. 
  • Sorties non prises en charge : l’API Reframe produit toujours une sortie H.264 ou HEVC opaque. Tout arrière-plan transparent (canal Alpha) est aplati, car la transparence Alpha n’est pas conservée. ProRes est accepté en entrée pour le décodage, mais n’est pas produit en sortie.