Cómo funciona
El escalado de vídeo usa el mismo sistema de cola asíncrono que la generación de vídeo:- Encolar — envía tu vídeo a
/video/queuecon el modelotopaz-video-upscale - Polling — consulta
/video/retrievecon elqueue_iddevuelto hasta que el estado seacompleted - Completar — llama a
/video/completepara finalizar y obtener la URL de salida
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
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 paratopaz-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
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.