Skip to main content
L’upscaling video ti permette di migliorare video esistenti portandoli a risoluzioni più alte e migliorando al contempo la qualità visiva. Il modello Topaz Video Upscale usa upscaling guidato dall’AI per aumentare la risoluzione di 2x o 4x, oppure per applicare un miglioramento della qualità alla risoluzione originale (1x).

Come funziona

L’upscaling video usa lo stesso sistema di queue asincrono della generazione video:
  1. Queue — Invia il tuo video a /video/queue con il modello topaz-video-upscale
  2. Polling — Controlla /video/retrieve con il queue_id restituito finché lo stato non è completed
  3. Complete — Chiama /video/complete per finalizzare e ottenere l’URL di output
Il server rileva automaticamente la durata, il frame rate e le dimensioni del video di input dal file caricato. Non hai bisogno di fornire questi valori — la fatturazione viene calcolata dai metadati effettivi del video.

Fattori di upscale

Il parametro upscale_factor sostituisce resolution per i modelli di upscale. Passare resolution restituirà un errore. Questo perché la risoluzione di output dipende dalle dimensioni del video di input — un upscale 2x di un video 720p produce un risultato diverso da un upscale 2x di un video 480p.

Formati di input supportati

  • Formati: MP4, MOV, WebM
  • Metodi di input: URL HTTPS o data URL data:video/...;base64,...
  • Durata massima: 300 secondi (5 minuti)

Utilizzo dell’API

Mettere in coda un job di upscale

La risposta include un queue_id per tracciare il job:

Polling per il completamento

Finalizzare con complete

Dopo aver recuperato il risultato, chiama /video/complete per finalizzare:

Parametri API

Parametri non usati per i modelli di upscale

I seguenti parametri non sono accettati per topaz-video-upscale e restituiranno un errore se forniti: Anche il parametro duration viene ignorato — il server rileva la durata direttamente dal file video per garantire l’accuratezza della fatturazione.

Prezzi

I prezzi sono basati su durata, tier di risoluzione di output e frame rate. Il tier di risoluzione di output è determinato dall’altezza del video di input moltiplicata per il fattore di upscale.

Tier di risoluzione di output

I video con frame rate sopra i 48fps costano il doppio della tariffa al secondo.

Esempi di prezzi

Usa la Video Quote API per ottenere prezzi esatti prima di inviare un job.

Ottenere un preventivo

L’endpoint quote accetta input_height in modo da poter stimare il tier di risoluzione di output. È opzionale — se omesso, il preventivo assume una stima conservativa.

Troubleshooting