Skip to main content
O upscaling de vídeo permite aprimorar vídeos existentes para resoluções mais altas enquanto melhora a qualidade visual. O modelo Topaz Video Upscale usa upscaling com IA para aumentar a resolução em 2x ou 4x, ou aplicar aprimoramento de qualidade na resolução original (1x).

Como funciona

O upscaling de vídeo usa o mesmo sistema de fila assíncrona da geração de vídeo:
  1. Enfileire — Envie seu vídeo para /video/queue com o modelo topaz-video-upscale
  2. Polling — Verifique /video/retrieve com o queue_id retornado até o status ser completed
  3. Complete — Chame /video/complete para finalizar e obter a URL de saída
O servidor detecta automaticamente a duração, taxa de frames e dimensões do vídeo de entrada a partir do arquivo enviado. Você não precisa fornecer esses valores — a cobrança é calculada a partir dos metadados reais do vídeo.

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

A resposta inclui um 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 para topaz-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

O endpoint de cotação aceita 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.

Solução de problemas