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 :- File d’attente — Soumettez votre vidéo à
/video/queueavec le modèletopaz-video-upscale - Sondage — Appelez
/video/retrieveavecmodelet lequeue_idretourné. 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. - Nettoyage (optionnel) — Après avoir enregistré le fichier, appelez
/video/completepour supprimer la sortie stockée
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
queue_id pour suivre la tâche :
Sonder et enregistrer le résultat
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 pourtopaz-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.