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 — Chame
/video/retrievecommodele oqueue_idretornado. Enquanto o job é executado, ele retorna JSON com"status": "PROCESSING". Quando o job termina, o corpo da resposta é o MP4 com upscale (Content-Type: video/mp4), então salve-o em um arquivo. Não há URL de saída. - Limpeza (opcional) — Depois de salvar o arquivo, chame
/video/completepara excluir a saída armazenada
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 e salvamento do resultado
Content-Type antes de fazer o parsing. O exemplo em cURL imprime o content type de cada resposta: repita-o até que ele imprima video/mp4; nesse momento, upscaled.mp4 contém o vídeo. Se a resposta da fila incluiu um download_url, o retrieve retorna JSON com "status": "COMPLETED" e você baixa o arquivo a partir dessa URL. Veja Links de download privados.
Limpeza (opcional)
Depois de salvar o MP4, você pode chamar/video/complete para excluir a saída armazenada. Ele não retorna o vídeo nem uma URL.
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
video_url é obrigatório em cotações para modelos de upscale — o endpoint de cotação busca o arquivo e detecta duração, FPS e altura a partir dos bytes, então não há necessidade de fornecê-los. Omiti-lo retorna 400 com “video_url is required for quotes on this model”.
Cotações para modelos de upscale exigem uma chave de API. Requisições sem uma chave retornam 403.
Passe para /video/quote o mesmo upscale_factor (1, 2 ou 4) que você enviará para /video/queue, para que a cotação corresponda ao job. A cotação também aceita resolution ("2x" ou "4x") como um alias obsoleto para modelos de upscale; se ambos forem enviados, upscale_factor tem precedência.