API-gebruiksscenario's voor Reframe

De Reframe API wijzigt de beeldverhouding van een video door slim het belangrijkste deel van elke opname te volgen en het kader daaromheen opnieuw samen te stellen. Alle content in de opnieuw geframede output is uitsluitend afkomstig uit de bronvideo, en de API genereert nooit nieuwe pixels om ruimte te vullen.

Beste gebruiksscenario's

De Reframe API presteert betrouwbaar op:

• Video's die standaard sociale media-beeldverhoudingen vereisen: conversie van video's met een beeldverhouding van 16:9 naar 9:16, 1:1, 4:3 en 4:5 uitvoer voor verschillende kanalen is het hoofdgebruiksscenario. Je kunt ook een exacte uitvoerresolutie opgeven (bijvoorbeeld 1920×1080) voor pixelperfecte levering. 
• Live actie en echte beelden: interviews, productopnames, lifestyle- en eventbeelden, en andere met de camera opgenomen video's worden netjes opnieuw geframed. Natuurlijke camerabeweging wordt automatisch vloeiend gemaakt, zonder zichtbare artefacten. 
• Opnames met één dominant onderwerp: het dominante onderwerp, zoals een persoon, product of brandpunt, blijft gedurende de hele hercompositie in beeld. Met Semantische onderwerpvergrendeling kun je het doelsubject benoemen met een zoekterm of opdracht (bijvoorbeeld man in een gele jas of frisbee), en de Reframe API zal het volgen door elke opname heen. 
• Video's met meerdere opnamen en nette overgangen: wanneer detectie van bewerkte scènes is geactiveerd, kan de API elke overgang analyseren en een stabiele compositie binnen elke opname behouden voor de beeldverhoudingen van alle output. 
• Video's die consistente overlays nodig hebben: vooraf gegenereerde overlays (PNG of GIF) kunnen worden toegepast met controle over timing, positie, schaal en herhaling, en blijven uitgelijnd over alle beeldverhoudingen die je genereert.

Ongeschikte gebruiksscenario's

Omdat de Reframe API alleen herpositioneert en uitsnijdt binnen bestaande pixels, genereert het nooit nieuwe content om ruimte te vullen. Bij de volgende contenttypes neemt de kwaliteit af of treedt een fout op wanneer ze opnieuw worden geframed:

• Schermvullende tekst en lower-thirds: titels, ondertiteling, tegoeden en afbeeldingen die in de bronvideo zijn ingebrand, beslaan de volledige breedte van de oorspronkelijke beeldverhouding. Wanneer het kader wordt uitgesneden naar een smallere verhouding, zoals van 16:9 naar 9:16, kapt de Reframe API de tekst aan de randen af omdat het ingebrande content niet opnieuw kan laten vloeien—het kan alleen het uitsnijdvenster verplaatsen. Frame bij video's met tekst en afbeeldingen eerst schone video's opnieuw en gebruik dan DGR (met verschillende MOGRT-formaten) om er tekst als overlay op te leggen.
• Scènes met meerdere onderwerpen met gelijktijdige actie: Semantische onderwerpvergrendeling kan slechts één onderwerp gedurende de hercompositie volgen. Wanneer twee of meer onderwerpen even belangrijk en ruimtelijk gescheiden zijn, zoals een interview met twee personen in een wide shot, een panel of een sportspel met een bal en een verre speler, kan de uitsnede slechts één onderwerp vasthouden. De andere vallen buiten het kader.
• Snelle of onduidelijke scèneovergangen: detectie van bewerkte scènes handhaaft de integriteit van de compositie bij overgangen, maar bij zeer snelle overgangen, harde flits-overgangen of afgestemde overgangen kan het gebeuren dat de onderwerptracker op het verkeerde element focust, waardoor sprongen in het uitsnijdpad ontstaan. 
• Grafische content met vaste compositie: schermopnames, diavoorstellingen, dashboards en beeldmateriaal met uitgebreide motion graphics hebben geen volgbaar onderwerp en geen veilige bijsnijding. De Reframe API behandelt elke pixel in dergelijke content als belangrijk, en daarom moet dergelijke content niet naar de API worden verzonden.
• Animatie en motion graphics: geanimeerde content, zoals logo-opbouw, kinetische typografie, titelsequenties en merkanimaties, laat zich niet betrouwbaar herkaderen. Dergelijke content bevat vaak scherpe grafische randen en snelbewegende elementen die nauwkeurige, frame voor frame kadrering vereisen, en het combineert vaak meerdere elementen die tegelijkertijd in verschillende richtingen bewegen. De Reframe API is afgestemd op echte beeldopnames en kan geanimeerde elementen niet nauwkeurig genoeg volgen, waardoor de uitvoer er enigszins vreemd uit kan zien of de beweging kan achterlopen. Voor animatie render je elke beeldverhouding vanuit de oorspronkelijke animatiebron, of de MOGRT via DGR, in plaats van een voltooide export opnieuw te kaderen. 
• Niet-ondersteunde uitvoer: de Reframe API produceert altijd dekkende H.264- of HEVC-output. Elke transparante achtergrond (een alfakanaal) wordt afgevlakt, omdat alfa niet wordt behouden. ProRes wordt geaccepteerd als invoer voor decodering, maar niet geproduceerd als uitvoer.