Casi d'uso dell'API Reframe

Ultimo aggiornamento il 22 set 2026

Scopri l'API Reframe e i casi d'uso per cui è più adatta.

L'API Reframe modifica le proporzioni di un video tracciando in modo intelligente la parte più importante di ogni ripresa e ricomponendo il fotogramma attorno ad essa.Tutto il contenuto nell'output rinquadrato deriva esclusivamente dal video di origine e l'API non genera mai nuovi px per riempire lo spazio.

Casi d'uso migliori

L'API Reframe funziona in modo affidabile su:

  • Video che richiedono proporzioni standard per i social media: La conversione di video con proporzioni 16:9 in output 9:16, 1:1, 4:3 e 4:5 per diversi canali è il caso d'uso principale.Puoi anche specificare una risoluzione di output esatta (ad esempio, 1920×1080) per una distribuzione pixel-perfect. 
  • Filmati dal vivo e del mondo reale: interviste, riprese di prodotti, filmati di lifestyle ed eventi e altri video catturati con la fotocamera vengono rinquadrati in modo pulito.Il movimento naturale della fotocamera viene stabilizzato automaticamente, senza artefatti visibili. 
  • Riprese con un soggetto dominante: Il soggetto dominante, come una persona, un prodotto o un punto focale, rimane nel fotogramma per tutta la ricomposizione.Con Semantic Subject Lock, puoi indicare il soggetto target usando una parola chiave o un prompt (ad esempio, uomo con giacca gialla o frisbee) e l'API Reframe lo traccerà in ogni ripresa. 
  • Video con più riprese e tagli puliti: Il rilevamento delle modifiche di scena, quando attivato, consente all'API di analizzare ogni transizione e mantenere una composizione stabile all'interno di ogni ripresa in tutte le proporzioni di output. 
  • Video che richiedono sovrapposizioni coerenti: Le sovrapposizioni pre-generate (PNG o GIF) possono essere applicate con controllo su tempo, posizione, scala e ripetizione in loop, e rimangono allineate in tutte le proporzioni che generi.

Casi d'uso poco adatti

Poiché l'API Reframe riposiziona e ritaglia solo all'interno dei pixel esistenti, non genera mai nuovo contenuto per riempire lo spazio. I seguenti tipi di contenuto possono risultare di qualità inferiore o non funzionare correttamente quando vengono reinquadrati:

  • Testo a schermo intero e lower-third: titoli, didascalie, crediti e grafiche incorporate nel video di origine occupano l'intera larghezza delle proporzioni originali.Quando il fotogramma viene ritagliato a un rapporto più stretto, come da 16:9 a 9:16, l'API Reframe tronca il testo ai bordi perché non può ridisporre il contenuto incorporato: può solo spostare la finestra di ritaglio. Per video con testo e grafiche, rinquadra prima i video puliti, quindi usa DGR (con MOGRT di dimensioni diverse) per sovrapporre il testo su di essi.
  • Scene con più soggetti e azione simultanea: Semantic Subject Lock può tracciare solo un soggetto durante la ricomposizione.Quando due o più soggetti sono ugualmente importanti e separati nello spazio, come un'intervista a due persone in un'inquadratura ampia, un panel o una giocata sportiva con una palla e un giocatore distante, il ritaglio può mantenere solo un soggetto.Gli altri restano fuori dal fotogramma.
  • Tagli di scena rapidi o ambigui: Il rilevamento delle modifiche di scena mantiene l'integrità compositiva tra le transizioni, ma i tagli molto veloci, le transizioni con flash intensi o i match cut possono causare il blocco del tracciamento del soggetto sull'elemento sbagliato, producendo salti nel percorso di ritaglio. 
  • Contenuto grafico a composizione fissa: le registrazioni dello schermo, le presentazioni, i dashboard e i filmati con motion graphics estese non hanno soggetti tracciabili e nessun ritaglio sicuro. L'API Reframe considera importante ogni pixel di tali contenuti, pertanto questi contenuti non dovrebbero essere inviati all'API.
  • Animazione e motion graphics: i contenuti animati, come la costruzione di loghi, la Composizione tipografica cinetica, le sequenze di titoli e le animazioni di branding, non si riformattano in modo affidabile. Tali contenuti spesso presentano bordi grafici nitidi ed elementi in movimento veloce che richiedono un'inquadratura precisa, fotogramma per fotogramma, e spesso combinano più elementi che si muovono contemporaneamente in direzioni diverse.L'API Reframe è ottimizzata per filmati reali e non può tracciare gli elementi animati con sufficiente precisione, quindi l'output potrebbe sembrare leggermente sfasato o in ritardo rispetto al movimento. Per l'animazione, esegui il rendering di ogni proporzione dall'origine dell'animazione originale, o del relativo MOGRT tramite DGR, invece di riformattare un'esportazione finita. 
  • Output non supportati: L' API Reframe produce sempre output H.264 o HEVC opachi. Qualsiasi sfondo trasparente (un canale alfa) viene appiattito, poiché l'alfa non viene preservato. ProRes è accettato come input per la decodifica, ma non prodotto come output.