Pular para o conteúdo principal
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 — Chame /video/retrieve com model e o queue_id retornado. 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.
  3. Limpeza (opcional) — Depois de salvar o arquivo, chame /video/complete para excluir a saída armazenada
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 e salvamento do resultado

O upscale finalizado é o próprio corpo da resposta, não um campo JSON, então verifique o 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 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”. 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.

Solução de problemas