Blog

Guía de uso

Uso de topaz-upscale/video con la API de HiAPI: flujo de trabajo para mejorar la calidad de videos cortos

Interpolación de fotogramas, ajustes de mejora y una solicitud de HiAPI funcional para video vertical

Nov 20, 2026
Ilustración de portada abstracta con grandes prismas bisecados en facetas de verde salvia y verde neblina sobre un fondo de pino profundo, estilo editorial geométrico plano.
En esta página

Por qué los videos cortos necesitan su propia estrategia de mejora de calidad

Los videos cortos verticales —esos clips de quince a sesenta segundos que se ven en la pantalla del móvil— fallan de manera distinta a los videos largos. Un documental horizontal puede ocultar una imagen blanda con desenfoque de movimiento y detalle de fondo. Un clip vertical se mira con toda la atención, se recorta a un encuadre estrecho y a menudo lo recomprime la plataforma de alojamiento. Cualquier debilidad del video de origen se amplifica en lugar de perdonarse.

Esto cambia el problema que debe resolver la mejora de calidad. Con material largo, quizá solo tengas que mejorar un máster y listo. Con videos cortos, normalmente trabajas con un archivo de origen que ya se codificó una vez (o dos) para móvil y luego se entregó a una plataforma que lo volverá a codificar. El objetivo no es solo un número de resolución más alto, sino un archivo que sobreviva a la siguiente ronda de compresión: bordes limpios, movimiento estable y detalle uniforme en todo el fotograma.

Por eso, trátalo como una cadena de procesamiento y no como una sola llamada:

  1. Normaliza el archivo de origen: recorta al punto de corte exacto, fija la relación de aspecto y define la velocidad de fotogramas antes de mejorar la calidad.
  2. Mejora y realza con topaz-upscale/video, configurando con criterio la interpolación de fotogramas y la mejora.
  3. Valida que la salida coincida con el origen antes de publicar, porque la mejora de calidad, al mismo tiempo que afila la imagen, también puede alisar fácilmente la textura.

Cada paso tiene su propio modo de fallo. Recortar el clip equivocado desperdicia tiempo de ejecución. Una interpolación descuidada genera movimiento poco natural. Saltarse la validación lleva los defectos directamente al espectador. El resto de esta guía explica en orden cada decisión y luego muestra una solicitud de HiAPI funcional que puedes adaptar a tu propio material.

En un clip vertical, la densidad de facetas —y con ella la resolución— crece mientras se mantiene la relación de aspecto.

Qué hace topaz-upscale/video en HiAPI

topaz-upscale/video es el endpoint de mejora de calidad de video del catálogo de modelos de HiAPI. Le envías material de video y ajustes, y devuelve un video con la calidad mejorada. Ese es todo el contrato; el resto es configuración.

Ubícalo así en tu cadena de procesamiento:

  • Entrada: un video accesible por la API, normalmente la URL de tu archivo de origen. La normalización de la relación de aspecto y el recorte ya se hicieron antes de este paso; el modelo solo mejora lo que le entregas.
  • Procesamiento: el servicio ejecuta tu clip con los ajustes de mejora y realce que especifiques, incluida la interpolación de fotogramas cuando la activas.
  • Salida: el material de video con calidad mejorada al que hace referencia el resultado de la tarea, que descargas y entregas al paso de publicación.

Algunas notas prácticas para desarrolladores:

  • Es una tarea, no una respuesta síncrona. El procesamiento de video tarda en proporción a la duración y a los ajustes, así que la API devuelve una tarea en la primera respuesta (para consultarla o esperar), no el archivo final.
  • El tiempo de ejecución crece con la duración del clip. Los clips más largos o los ajustes más pesados consumen más tiempo de procesamiento. Los videos cortos son una ventaja en este sentido: iterar cuesta poco.
  • Los parámetros se rigen por la documentación en línea. Los nombres exactos de los parámetros, los valores aceptados y los valores predeterminados de topaz-upscale/video los define la documentación actual del modelo en HiAPI. No supongas que un parámetro existe porque una herramienta de escritorio u otro proveedor use un nombre parecido. Consulta la página del modelo antes de construir.

El modelo ocupa exactamente una posición en tu cadena de procesamiento: después de la normalización y antes de la validación y la publicación. Mantén clara esa frontera y el resto del flujo de trabajo seguirá siendo sencillo.

El modelo actúa como una única etapa de procesamiento en la cadena: entra un video y sale un video con la calidad mejorada.

Planificar la interpolación de fotogramas para el ritmo de los videos cortos

La interpolación de fotogramas sintetiza fotogramas intermedios para aumentar la velocidad de fotogramas efectiva; por ejemplo, convertir un origen de 24 o 30 fps en una salida más fluida de 60 fps. En videos cortos es tentador activarla en todas partes porque el movimiento fluido parece más profesional. Pero esa intuición suele ser errónea.

Cuándo ayuda la interpolación

  • Movimientos de cámara rápidos o barridos. Los clips verticales suelen usar movimiento rápido que tiembla a baja velocidad de fotogramas. La interpolación puede suavizar los barridos.
  • Cámara lenta o secuencias con velocidad alterada. Si grabas a baja velocidad de fotogramas y luego ralentizas, la interpolación puede rellenar los huecos y reducir el tartamudeo.
  • Velocidad de fotogramas de origen ya cercana a la objetivo. Pasar de 30 fps a 60 fps es una mejora moderada y predecible.

Cuándo solo añade coste sin beneficio visible

  • Planos de talking head estáticos. Si la imagen apenas cambia, los fotogramas interpolados son casi idénticos a los vecinos. Pagas tiempo de ejecución sin obtener nada.
  • Orígenes ya de alta velocidad de fotogramas. Interpolar de 60 fps a 120 fps probablemente no sobreviva de todos modos a la recodificación de la plataforma.
  • Orígenes con desenfoque de movimiento intenso o calidad muy baja. La interpolación adivina movimientos que no puede ver bien, y esas suposiciones aparecen como distorsión o doble imagen cerca de los bordes.

Un valor predeterminado prudente

Para la mayoría del trabajo con videos cortos, empieza con la interpolación desactivada, mejora la calidad a la velocidad de fotogramas de origen y luego revisa el resultado. Si el movimiento tiembla, activa la interpolación con la velocidad de fotogramas objetivo más baja que resuelva el problema. Cambia solo una variable a la vez, así sabrás qué produjo la mejora —o el defecto—.

Ten en cuenta también que la interpolación interactúa con el tiempo de ejecución. Cada fotograma interpolado es trabajo adicional. La diferencia es pequeña en un clip de quince segundos, pero se acumula en lotes de cientos o miles. Mide en un clip representativo antes de aplicar un ajuste a toda la cola.

Elegir los ajustes de mejora sin adivinar

Los ajustes de mejora controlan con qué intensidad el modelo enfoca, reduce el ruido y recupera detalle. No existe una configuración «óptima» universal, porque la cantidad adecuada depende de la calidad de tu origen y de dónde se publicará el clip.

Parte del origen, no del objetivo

Antes de tocar cualquier ajuste, hazte dos preguntas sobre la entrada:

  1. ¿Qué tan limpio está el origen? Un material de cámara nítido soporta una mejora ligera. Un origen muy recomprimido o de bajo bitrate requiere más contención, porque la mejora amplifica los artefactos de compresión junto con el detalle real.
  2. ¿Qué hará la plataforma con él? Todas las plataformas principales de video corto recodifican lo que se sube. Un enfoque agresivo que se ve bien en tu monitor puede convertirse en ringing y halos tras la segunda codificación.

Un marco de decisión práctico

  • Material original de alta calidad, mejora moderada: usa una mejora conservadora. Deja que el escalador haga el trabajo y mantén el enfoque al mínimo para que la textura sobreviva a la compresión de la plataforma.
  • Orígenes blandos o ya comprimidos: apóyate primero en la reducción de ruido y luego aplica un enfoque moderado. Enfocar en exceso una fuente con ruido produce bordes duros y quebradizos, más desagradables que la blandura original.
  • Texto, rostros y detalle de producto: los clips verticales suelen depender de subtítulos legibles y rostros nítidos. Valida estas zonas específicamente: una mejora que ayuda al paisaje puede emborronar texto fino.
  • Clips con mucho movimiento: combina una mejora conservadora con tu decisión sobre la interpolación. El enfoque intenso más la interpolación son la causa más común de artefactos de parpadeo.

Confirma las opciones realmente disponibles

Los parámetros exactos de mejora, sus rangos aceptados y cualquier preajuste los define la documentación en línea del modelo topaz-upscale/video en HiAPI. Los nombres de parámetros y los valores predeterminados pueden cambiar y no tienen por qué coincidir con otras herramientas que hayas usado. Lee la página del modelo, define los valores explícitamente en la solicitud y evita depender de valores predeterminados recordados. Si dudas, ejecuta dos configuraciones sobre el mismo clip corto y compáralas: eso es más barato que adivinar en todo un lote.

Una solicitud funcional de topaz-upscale/video en HiAPI

Antes de escribir la solicitud, define dos variables de entorno para que tu clave nunca llegue al control de versiones:

export HIAPI_API_KEY="your_api_key_here"
export SOURCE_VIDEO="https://your-bucket.example.com/clips/cut_vertical.mp4"

Ahora envía una tarea. La estructura siguiente es el patrón: apunta la solicitud al modelo, pasa la URL del video de origen e incluye explícitamente tus ajustes de mejora e interpolación. Consulta en la documentación del modelo de HiAPI los nombres exactos de los parámetros y los valores aceptados de topaz-upscale/video, y luego ajusta el cuerpo de la solicitud para que coincida.

curl -X POST "https://api.hiapi.ai/v1/models/topaz-upscale/video/jobs" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "video_url": "'"$SOURCE_VIDEO"'"
    },
    "settings": {
      "upscale": {
        "target_resolution": "1080p"
      },
      "frame_interpolation": {
        "enabled": false
      },
      "enhancement": {
        "strength": "conservative"
      }
    }
  }'

Qué esperar y cómo actuar:

  • La respuesta contiene un identificador de tarea y un estado. Guarda el ID de la tarea: lo necesitarás para obtener el resultado.
  • Consulta o espera. Los clips cortos terminan rápido, pero escribe siempre tu cliente para manejar el estado pendiente en lugar de suponer que ya terminó en la primera lectura.
  • Obtén el material de salida descargándolo de la tarea completada a tu propio almacenamiento antes de añadirlo a la cola de publicación.
  • Reenvía en lugar de parchear. Si quieres probar la interpolación activada, envía una nueva tarea con la marca cambiada. Mantén una sola variable por tarea para que la comparación sea honesta.

La primera solicitud también es tu validación más rápida: ejecútala con tu propio clip, con la relación de aspecto y la duración reales, antes de construir cualquier automatización alrededor de ella.

Ciclo de vida de la solicitud: la tarea entra en la cola, se consulta y finalmente se resuelve en material de salida.

Validar el resultado e integrar la mejora de calidad en la cadena de procesamiento

Un archivo con la calidad mejorada no es automáticamente un archivo mejor. La validación es el paso que convierte una llamada al modelo en un flujo de trabajo fiable.

Qué revisar

  • Bordes y detalle fino. Amplía texto, rostros y bordes duros. Busca halos, ringing o textura emborronada que no estuvieran en el origen.
  • Coherencia del movimiento. Mira los clips de movimiento rápido a velocidad normal. Los artefactos de interpolación aparecen como distorsión o doble imagen en fotogramas individuales: pausa y revisa fotograma a fotograma.
  • Color y exposición. Confirma que la salida no tiene desviaciones de tono o brillo; la mejora puede alterar sutilmente el contraste.
  • Audio y duración. Asegúrate de que el clip tiene la misma longitud y la pista de audio está completa al milisegundo. Una pista de audio que se desfasa tras la recodificación rompe la sincronización de los subtítulos.
  • Después de la compresión de la plataforma. Sube una copia de prueba en privado y revisa la versión recodificada, porque eso es lo que verá realmente el espectador.

Dónde colocarlo en la cadena de procesamiento

Una cadena de procesamiento limpia para videos cortos es así:

  1. Edita y exporta el corte final con la resolución nativa y una velocidad de fotogramas estable.
  2. Sube el archivo de origen a un almacenamiento accesible por la API.
  3. Envía la tarea de mejora de calidad con ajustes explícitos y registra el ID de la tarea junto con el clip.
  4. Descarga y valida la salida con las comprobaciones anteriores.
  5. Publica: directamente o en una cola de publicación programada multiplataforma.

Dos notas operativas. Conserva el archivo de origen original; nunca lo sobrescribas con la versión mejorada, porque querrás volver a ejecutarlo con otros ajustes. Y registra los ajustes de cada clip, de modo que cuando una salida no se vea bien puedas rastrear exactamente qué configuración la produjo. Esa trazabilidad te permite ajustar los valores con el tiempo en lugar de volver a adivinar en cada lote.

Costes, límites y aspectos que confirmar antes de escalar

Antes de dirigir tráfico de producción a topaz-upscale/video, confirma los detalles operativos en la documentación actual del modelo en HiAPI, no a partir de suposiciones basadas en otras herramientas.

  • Base de facturación. Averigua cómo factura el modelo —por ejemplo, por duración de salida o por tramo de resolución— y consulta el panel de precios en tiempo real para conocer las cifras actuales. Los precios pueden cambiar, y esto es algo que nunca deberías codificar de memoria o a partir de publicaciones de foros.
  • Límites de duración y tamaño de archivo. Las entradas tienen una duración y un tamaño máximos; los videos cortos suelen quedar holgadamente dentro del límite, pero los trabajos por lotes con orígenes más largos quizá no. Confirma los límites antes de enviar.
  • Rendimiento y concurrencia. Cuántas tareas puedes ejecutar en paralelo y si existen límites de velocidad determina la forma de la cola. Diseña tu cliente para retroceder y reintentar cuando reciba una respuesta de límite de velocidad.
  • Comportamiento ante tiempos de espera. Las tareas de video pueden tardar más que una solicitud HTTP típica. Confirma el intervalo de consulta recomendado y la ventana de retención de tareas.
  • Estabilidad de los parámetros. Trata los ajustes del modelo como parte de un contrato en línea. Lee la documentación al integrar y vuelve a revisarla cuando el comportamiento sea inesperado.

Un buen patrón de escalado: valida un clip representativo, mide su tiempo de ejecución y coste reales, y luego extrapola de forma conservadora añadiendo un margen. Mantén los precios y los límites en la configuración y no en el código, para que las actualizaciones solo requieran cambiar la configuración sin necesidad de desplegar.

Empieza con un solo clip en topaz-upscale/video, valídalo y luego escala: es la vía más rápida hacia una cadena de procesamiento fiable para mejorar la calidad de videos cortos.

Artículos relacionados

Ver todos los artículos →

Empieza a crear con artefactos de IA persistentes

Consigue tu API key y llama a modelos de imagen, vídeo y audio a través de una única API basada en tasks.

Leer la documentación de la API