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 — llama a
/video/retrieveconmodely elqueue_iddevuelto. Mientras el trabajo se ejecuta, devuelve JSON con"status": "PROCESSING". Cuando el trabajo termina, el cuerpo de la respuesta es el MP4 escalado (Content-Type: video/mp4), así que guárdalo en un archivo. No hay URL de salida. - Limpieza (opcional) — después de guardar el archivo, llama a
/video/completepara eliminar la salida almacenada
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 y guardado del resultado
Content-Type antes de analizarlo. El ejemplo de cURL imprime el tipo de contenido de cada respuesta: repítelo hasta que imprima video/mp4, momento en el que upscaled.mp4 contiene el vídeo. Si la respuesta de la cola incluyó un download_url, retrieve devuelve en su lugar JSON con "status": "COMPLETED", y descargas el archivo desde esa URL. Consulta Enlaces de descarga privados.
Limpieza (opcional)
Después de guardar el MP4, puedes llamar a/video/complete para eliminar la salida almacenada. No devuelve el vídeo ni una URL.
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
video_url es obligatorio para las cotizaciones en modelos de upscaling: el endpoint de cotización descarga el archivo y detecta la duración, los FPS y la altura a partir de los bytes, por lo que no hace falta proporcionarlos. Omitirlo devuelve 400 con “video_url is required for quotes on this model”.
Las cotizaciones para modelos de upscaling requieren una API key. Las solicitudes sin ella devuelven 403.
Pasa a /video/quote el mismo upscale_factor (1, 2 o 4) que enviarás a /video/queue, para que la cotización coincida con el trabajo. Quote también acepta resolution ("2x" o "4x") como alias obsoleto para los modelos de upscaling; si se envían ambos, upscale_factor tiene prioridad.