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

video_url è obbligatorio per i preventivi sui modelli di upscale — l’endpoint quote scarica il file e rileva durata, FPS e altezza dai byte, quindi non c’è bisogno di fornirli. Ometterlo restituisce 400 con “video_url is required for quotes on this model”.
Gli endpoint quote e queue attualmente denominano il fattore di upscale in modo diverso: /video/queue accetta upscale_factor (1, 2 o 4), mentre /video/quote legge il fattore da resolution ("2x" o "4x"). Inviare upscale_factor all’endpoint quote non ha effetto — ricade sul default "2x" e restituisce un prezzo 2x per quello che potrebbe essere un job 4x. Quando richiedi un preventivo per un upscale 4x, passa resolution: "4x".

Troubleshooting