Casos de uso da API Reframe

Última atualização em 22 de set de 2026

Saiba mais sobre a API Reframe e os casos de uso mais adequados para ela.

A API Reframe modifica a proporção de um vídeo rastreando de forma inteligente a parte mais importante de cada cena e recompondo o quadro em torno dela. Todo o conteúdo da saída reenquadrada é derivado exclusivamente do vídeo de origem, e a API nunca gera novos pixels para preencher espaço.

Melhores casos de uso

A API Reframe funciona de forma confiável em:

  • Vídeos que precisam de proporções padrão de redes sociais: A conversão de vídeos com proporção 16:9 para saídas 9:16, 1:1, 4:3 e 4:5 para diferentes canais é o principal caso de uso. Você também pode especificar uma resolução de saída exata (por exemplo, 1920×1080) para entrega perfeita de pixels. 
  • Gravação de ação ao vivo e do mundo real: Entrevistas, fotos de produtos, gravação de estilo de vida e eventos, e outros vídeos capturados por câmera são reenquadrados de forma limpa. O movimento natural da câmera é automaticamente suavizado, sem artefatos visíveis. 
  • Cenas com um assunto dominante: o assunto dominante, como uma pessoa, produto ou ponto focal, permanece no quadro durante toda a recomposição. Com o Bloqueio semântico de assunto, você pode nomear o assunto alvo usando uma palavra-chave ou prompt (por exemplo, homem de jaqueta amarela ou frisbee), e a Reframe API irá rastreá-lo em cada cena. 
  • Vídeos com múltiplas cenas e cortes limpos: a detecção de edição de cena, quando ativada, permite que a API analise cada transição e mantenha uma composição estável dentro de cada cena em todas as proporções de saída. 
  • Vídeos que precisam de sobreposições consistentes: Sobreposições pré-geradas (PNG ou GIF) podem ser aplicadas com Controle sobre duração, posição, escala e looping, e permanecem alinhadas em todas as proporções geradas.

Casos de uso inadequados

Como a API Reframe apenas reposiciona e recorta dentro de pixels existentes, ela nunca gera novo conteúdo para preencher espaço. Os seguintes tipos de conteúdo irão se degradar ou falhar quando reenquadrados:

  • Texto na tela em quadro completo e terços inferiores: títulos, legendas, créditos e gráficos incorporados no vídeo de origem ocupam toda a largura da proporção original. Quando o quadro é cortado para uma proporção mais estreita, como de 16:9 para 9:16, a API Reframe trunca o texto nas bordas porque não pode refluir conteúdo incorporado—ela só pode mover a janela de corte. Para vídeos com texto e gráficos, reenquadre vídeos limpos primeiro, e então use DGR (com MOGRTs de tamanhos diferentes) para sobrepor texto neles.
  • Cenas com múltiplos assuntos com ação simultânea: o Bloqueio semântico de assunto pode rastrear apenas um assunto durante toda a recomposição. Quando dois ou mais assuntos são igualmente importantes e espacialmente separados, como uma entrevista de duas pessoas em plano aberto, um painel, ou uma jogada esportiva com uma bola e um jogador distante, o corte só pode manter um assunto. Os outros ficam fora do quadro.
  • Cortes de cena rápidos ou ambíguos: a detecção de edição de cena mantém a integridade composicional nas transições, mas cortes muito rápidos, transições de flash intenso ou cortes combinados podem fazer com que o rastreador de assunto se fixe no elemento errado, produzindo saltos no caminho de corte. 
  • Conteúdo gráfico de composição fixa: gravações de tela, apresentações de slides, painéis e gravações com animações extensas não têm assunto rastreável e nenhum corte seguro. A API Reframe trata cada pixel em tal conteúdo como importante, e por isso tal conteúdo não deve ser enviado para a API.
  • Animação e animações: conteúdo animado, como construções de logotipo, Tipografia cinética, sequências de título e animações de marca, não se reenquadra de forma confiável. Tal conteúdo frequentemente apresenta bordas gráficas nítidas e elementos em movimento rápido que exigem enquadramento preciso, quadro a quadro, e frequentemente combina múltiplos elementos se movendo em direções diferentes ao mesmo tempo. A API Reframe é ajustada para gravações do mundo real e não pode rastrear elementos animados com precisão suficiente, então a saída pode parecer ligeiramente desalinhada ou atrasar o movimento. Para animações, renderize cada proporção de tela a partir da fonte original da animação ou de seu MOGRT por meio do DGR, em vez de reajustar o enquadramento de uma exportação finalizada. 
  • Saídas não suportadas: A API Reframe sempre produz saída H.264 ou HEVC opaca. Qualquer fundo transparente (um canal alfa) é achatado, pois o alfa não é preservado. ProRes é aceito como entrada para decodificação, mas não é produzido como saída.