Como funciona
O upscaling de vídeo usa o mesmo sistema de fila assíncrona da geração de vídeo:- Enfileire — Envie seu vídeo para
/video/queuecom o modelotopaz-video-upscale - Polling — Verifique
/video/retrievecom oqueue_idretornado até o status sercompleted - Complete — Chame
/video/completepara finalizar e obter a URL de saída
Fatores de upscale
O parâmetro
upscale_factor substitui resolution para modelos de upscale. Passar resolution retornará um erro. Isso é porque a resolução de saída depende das dimensões do vídeo de entrada — um upscale 2x de um vídeo 720p produz um resultado diferente de um upscale 2x de um vídeo 480p.Formatos de entrada suportados
- Formatos: MP4, MOV, WebM
- Métodos de entrada: URL HTTPS ou data URL
data:video/...;base64,... - Duração máxima: 300 segundos (5 minutos)
Uso da API
Enfileire um job de upscale
queue_id para rastrear o job:
Polling para conclusão
Finalize com complete
Após recuperar o resultado, chame/video/complete para finalizar:
Parâmetros da API
Parâmetros não usados para modelos de upscale
Os seguintes parâmetros não são aceitos paratopaz-video-upscale e retornarão um erro se fornecidos:
O parâmetro
duration também é ignorado — o servidor detecta a duração diretamente do arquivo de vídeo para precisão de cobrança.
Preços
A cobrança é baseada em duração, tier de resolução de saída e taxa de frames. O tier de resolução de saída é determinado pela altura do vídeo de entrada multiplicada pelo fator de upscale.Tiers de resolução de saída
Vídeos com taxas de frames acima de 48fps custam 2x a taxa por segundo.
Exemplos de preços
Use a API de cotação de vídeo para obter preços exatos antes de enviar um job.
Obtendo uma cotação
input_height para que possa estimar o tier de resolução de saída. Isso é opcional — se omitido, a cotação assume uma estimativa conservadora.