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 — Appelez /video/retrieve avec model et le queue_id retourné. Pendant l’exécution de la tâche, il renvoie du JSON avec "status": "PROCESSING". Lorsque la tâche est terminée, le corps de la réponse est le MP4 mis à l’échelle (Content-Type: video/mp4), enregistrez-le donc dans un fichier. Il n’y a pas d’URL de sortie.
  3. Nettoyage (optionnel) — Après avoir enregistré le fichier, appelez /video/complete pour supprimer la sortie stockée
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 et enregistrer le résultat

Le résultat final de la mise à l’échelle est le corps de la réponse lui-même, et non un champ JSON, vérifiez donc Content-Type avant d’analyser la réponse. L’exemple cURL affiche le type de contenu de chaque réponse : répétez-le jusqu’à ce qu’il affiche video/mp4, moment auquel upscaled.mp4 contient la vidéo. Si la réponse de mise en file d’attente comprenait un download_url, retrieve renvoie à la place du JSON avec "status": "COMPLETED", et vous téléchargez le fichier depuis cette URL. Voir Liens de téléchargement privés.

Nettoyage (optionnel)

Après avoir enregistré le MP4, vous pouvez appeler /video/complete pour supprimer la sortie stockée. Cet appel ne renvoie ni la vidéo ni une URL.

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

video_url est requis pour les devis sur les modèles d’upscaling — le endpoint de devis récupère le fichier et détecte la durée, le FPS et la hauteur à partir des octets, il est donc inutile de les fournir. L’omettre renvoie 400 avec “video_url is required for quotes on this model”. Les devis pour les modèles d’upscaling nécessitent une clé API. Les requêtes sans clé renvoient 403. Passez à /video/quote le même upscale_factor (1, 2 ou 4) que celui que vous enverrez à /video/queue, afin que le devis corresponde à la tâche. Le devis accepte aussi resolution ("2x" ou "4x") comme alias obsolète pour les modèles d’upscaling ; si les deux sont envoyés, upscale_factor est prioritaire.

Dépannage