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

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”.
Os endpoints de cotação e de fila atualmente nomeiam o fator de upscale de forma diferente: /video/queue recebe upscale_factor (1, 2 ou 4), enquanto /video/quote lê o fator de resolution ("2x" ou "4x"). Enviar upscale_factor ao endpoint de cotação não tem efeito — ele recai no padrão "2x" e retorna um preço de 2x para o que pode ser um job de 4x. Ao cotar um upscale de 4x, passe resolution: "4x".

Solução de problemas