Casos de uso de la Reframe API

Última actualización el 22 sep. 2026

Obtén información sobre la Reframe API y los casos de uso para los que está mejor adaptada.

La Reframe API modifica la relación de aspecto de un vídeo realizando un seguimiento inteligente de la parte más importante de cada toma y recomponiendo el marco a su alrededor. Todo el contenido de la salida reencuadrada se deriva únicamente del vídeo fuente, y la API nunca genera nuevos píxeles para rellenar el espacio.

Casos de uso recomendados

La Reframe API funciona de forma fiable en:

  • Vídeos que requieren relaciones de aspecto estándar de redes sociales: La conversión de vídeos con una relación de aspecto de 16:9 a salidas de 9:16, 1:1, 4:3 y 4:5 para diferentes canales es el principal caso de uso. También puedes especificar una resolución de salida exacta (por ejemplo, 1920×1080) para una entrega perfecta de píxeles. 
  • Metraje de acción en vivo y del mundo real: Las entrevistas, tomas de productos, metraje de estilo de vida y eventos, y otros vídeos capturados con cámara se reencuadran limpiamente. El movimiento natural de la cámara se suaviza automáticamente, sin artefactos visibles. 
  • Tomas con un sujeto dominante: El sujeto dominante, como una persona, producto o punto focal, se mantiene en el encuadre durante toda la recomposición. Con Semantic Subject Lock, puedes nombrar el sujeto objetivo usando una palabra clave o indicación (por ejemplo, hombre con chaqueta amarilla o frisbee), y la Reframe API lo rastreará en cada toma. 
  • Vídeos de múltiples tomas con cortes limpios: La detección de edición de escenas, cuando se activa, permite a la API analizar cada transición y mantener una composición estable dentro de cada toma en todas las relaciones de salida. 
  • Vídeos que necesitan superposiciones consistentes: Las superposiciones pregeneradas (PNG o GIF) se pueden aplicar con control sobre la temporización, posición, escala y reproducción en bucle, y se mantienen alineadas en todas las relaciones de aspecto que generes.

Casos de uso inadecuados

Como la Reframe API solo reposiciona y recorta dentro de los píxeles existentes, nunca genera contenido nuevo para rellenar el espacio. Los siguientes tipos de contenido se degradarán o fallarán cuando se reencuadren:

  • Texto a pantalla completa y tercios inferiores: Los títulos, subtítulos, créditos y gráficos grabados en el vídeo original ocupan toda la anchura de la relación de aspecto original. Cuando el marco se recorta a una proporción más estrecha, como de 16:9 a 9:16, la Reframe API trunca el texto en los bordes porque no puede redistribuir el contenido grabado, solo puede mover la ventana de recorte. Para vídeos con texto y gráficos, reencuadra primero los vídeos limpios y, a continuación, usa DGR (con MOGRT de diferentes tamaños) para superponer texto en ellos.
  • Escenas con múltiples sujetos con acción simultánea: Semantic Subject Lock puede rastrear solo un sujeto durante toda la recomposición. Cuando dos o más sujetos son igualmente importantes y están separados espacialmente, como una entrevista de dos personas en un plano amplio, un panel, o una jugada deportiva con una pelota y un jugador distante, el recorte solo puede mantener un sujeto. Los otros quedan fuera del marco.
  • Cortes de escena rápidos o ambiguos: La detección de edición de escena mantiene la integridad composicional a través de las transiciones, pero los cortes muy rápidos, las transiciones de flash intenso o los cortes coincidentes pueden hacer que el rastreador del sujeto se fije en el elemento incorrecto, produciendo saltos en la ruta de recorte. 
  • Contenido gráfico de composición fija: Las grabaciones de pantalla, las presentaciones de diapositivas, los paneles de control y el material con gráficos en movimiento extensos no tienen un sujeto rastreable ni recorte seguro. La API de Reframe trata cada píxel de dicho contenido como importante, por lo que tal contenido no debe enviarse a la API.
  • Animación y gráficos en movimiento: El contenido animado, como construcciones de logotipos, tipografía cinética, secuencias de títulos y animaciones de marca, no se reencuadra de manera fiable. Dicho contenido a menudo presenta bordes gráficos nítidos y elementos que se mueven rápidamente que requieren un encuadre preciso, fotograma a fotograma, y frecuentemente combina múltiples elementos moviéndose en diferentes direcciones a la vez. La API de Reframe está ajustada para material del mundo real y no puede rastrear elementos animados con suficiente precisión, por lo que el resultado puede verse ligeramente desfasado o rezagado en el movimiento. Para animación, procese cada relación de aspecto desde la fuente de animación original, o su MOGRT a través de DGR, en lugar de reencuadrar una exportación terminada. 
  • Resultados no compatibles: La API de Reframe siempre produce salida H.264 o HEVC opaca. Los fondos transparentes (con canal alfa) se aplanan, ya que alfa no se conserva. ProRes se acepta como entrada para decodificación, pero no se produce como salida.