Saltar al contenido principal
El escalado de vídeo te permite mejorar vídeos existentes a resoluciones más altas mientras mejoras la calidad visual. El modelo Topaz Video Upscale utiliza escalado impulsado por IA para aumentar la resolución 2x o 4x, o aplicar mejora de calidad a la resolución original (1x).

Cómo funciona

El escalado de vídeo usa el mismo sistema de cola asíncrono que la generación de vídeo:
  1. Encolar — envía tu vídeo a /video/queue con el modelo topaz-video-upscale
  2. Polling — consulta /video/retrieve con el queue_id devuelto hasta que el estado sea completed
  3. Completar — llama a /video/complete para finalizar y obtener la URL de salida
El servidor detecta automáticamente la duración, la tasa de frames y las dimensiones del vídeo subido. No necesitas proporcionar estos valores: la facturación se calcula a partir de los metadatos reales del vídeo.

Factores de escalado

El parámetro upscale_factor reemplaza a resolution para los modelos de escalado. Pasar resolution devolverá un error. Esto se debe a que la resolución de salida depende de las dimensiones del vídeo de entrada — un escalado 2x de un vídeo 720p produce un resultado diferente al escalado 2x de un vídeo 480p.

Formatos de entrada admitidos

  • Formatos: MP4, MOV, WebM
  • Métodos de entrada: URL HTTPS o data URL data:video/...;base64,...
  • Duración máxima: 300 segundos (5 minutos)

Uso de la API

Encolar un trabajo de escalado

La respuesta incluye un queue_id para hacer seguimiento del trabajo:

Polling de finalización

Finalizar con complete

Después de recuperar el resultado, llama a /video/complete para finalizar:

Parámetros de la API

Parámetros no usados para modelos de escalado

Los siguientes parámetros no se aceptan para topaz-video-upscale y devolverán un error si se proporcionan: El parámetro duration también se ignora — el servidor detecta la duración directamente del archivo de vídeo para la precisión de la facturación.

Precios

El precio se basa en duración, nivel de resolución de salida y tasa de frames. El nivel de resolución de salida se determina por la altura del vídeo de entrada multiplicada por el factor de escalado.

Niveles de resolución de salida

Los vídeos con tasas de frames superiores a 48fps cuestan 2x la tarifa por segundo.

Ejemplos de precios

Usa la API de cotización de vídeo para obtener precios exactos antes de enviar un trabajo.

Obtener una cotización

El endpoint de cotización acepta input_height para poder estimar el nivel de resolución de salida. Esto es opcional — si se omite, la cotización asume una estimación conservadora.

Resolución de problemas