Passer au contenu principal
La mise à l’échelle vidéo vous permet d’améliorer des vidéos existantes vers des résolutions plus élevées tout en améliorant la qualité visuelle. Le modèle Topaz Video Upscale utilise une mise à l’échelle pilotée par l’IA pour augmenter la résolution de 2x ou 4x, ou pour appliquer une amélioration de qualité à la résolution d’origine (1x).

Fonctionnement

La mise à l’échelle vidéo utilise le même système de file d’attente asynchrone que la génération vidéo :
  1. File d’attente — Soumettez votre vidéo à /video/queue avec le modèle topaz-video-upscale
  2. Sondage — Interrogez /video/retrieve avec le queue_id retourné jusqu’à ce que le statut soit completed
  3. Finalisation — Appelez /video/complete pour finaliser et obtenir l’URL de sortie
Le serveur détecte automatiquement la durée, la fréquence d’images et les dimensions de la vidéo d’entrée depuis le fichier téléversé. Vous n’avez pas besoin de fournir ces valeurs — la facturation est calculée à partir des métadonnées réelles de la vidéo.

Facteurs de mise à l’échelle

Le paramètre upscale_factor remplace resolution pour les modèles de mise à l’échelle. Passer resolution renverra une erreur. En effet, la résolution de sortie dépend des dimensions de la vidéo d’entrée — une mise à l’échelle 2x d’une vidéo 720p produit un résultat différent d’une mise à l’échelle 2x d’une vidéo 480p.

Formats d’entrée pris en charge

  • Formats : MP4, MOV, WebM
  • Méthodes d’entrée : URL HTTPS ou URL data data:video/...;base64,...
  • Durée maximale : 300 secondes (5 minutes)

Utilisation de l’API

Mettre en file d’attente une tâche de mise à l’échelle

La réponse contient un queue_id pour suivre la tâche :

Sonder jusqu’à la fin

Finaliser avec complete

Après avoir récupéré le résultat, appelez /video/complete pour finaliser :

Paramètres de l’API

Paramètres non utilisés pour les modèles de mise à l’échelle

Les paramètres suivants ne sont pas acceptés pour topaz-video-upscale et renverront une erreur s’ils sont fournis : Le paramètre duration est également ignoré — le serveur détecte la durée directement depuis le fichier vidéo pour une facturation précise.

Tarification

La tarification est basée sur la durée, le palier de résolution de sortie et la fréquence d’images. Le palier de résolution de sortie est déterminé par la hauteur de la vidéo d’entrée multipliée par le facteur de mise à l’échelle.

Paliers de résolution de sortie

Les vidéos avec une fréquence d’images supérieure à 48 ips coûtent 2x le tarif par seconde.

Exemples de tarification

Utilisez l’API Video Quote pour obtenir le tarif exact avant de soumettre une tâche.

Obtenir un devis

Le endpoint de devis accepte input_height afin de pouvoir estimer le palier de résolution de sortie. Ce champ est optionnel — s’il est omis, le devis suppose une estimation conservatrice.

Dépannage