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 :
- File d’attente — Soumettez votre vidéo à
/video/queue avec le modèle topaz-video-upscale
- Sondage — Interrogez
/video/retrieve avec le queue_id retourné jusqu’à ce que le statut soit completed
- 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
upscale_factor | Résolution de sortie | Cas d’usage |
|---|
1 | Identique à l’entrée | Amélioration de qualité uniquement (débruitage, accentuation) |
2 (par défaut) | 2x les dimensions d’entrée | Mise à l’échelle standard — une entrée 720p devient une sortie 1440p |
4 | 4x les dimensions d’entrée | Mise à l’échelle maximale — une entrée 480p devient une sortie 1920p |
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 : 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
curl https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "topaz-video-upscale",
"video_url": "https://example.com/input-video.mp4",
"upscale_factor": 2
}'
queue_id pour suivre la tâche :
{
"model": "topaz-video-upscale",
"queue_id": "abc123-def456-..."
}
Sonder jusqu’à la fin
curl https://api.venice.ai/api/v1/video/retrieve \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"queue_id": "abc123-def456-..."}'
Finaliser avec complete
Après avoir récupéré le résultat, appelez /video/complete pour finaliser :
curl https://api.venice.ai/api/v1/video/complete \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"queue_id": "abc123-def456-..."}'
Paramètres de l’API
| Champ | Type | Requis | Description |
|---|
model | string | Oui | Doit être topaz-video-upscale |
video_url | string | Oui | URL de la vidéo d’entrée ou URL data. Formats pris en charge : MP4, MOV, WebM. |
upscale_factor | number | Non | 1, 2 (par défaut) ou 4. Contrôle le multiplicateur de mise à l’échelle. |
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 :
| Champ | Raison |
|---|
resolution | Utilisez upscale_factor à la place. La résolution de sortie dépend des dimensions d’entrée. |
prompt | La mise à l’échelle n’utilise pas de prompts textuels. Une chaîne vide est définie automatiquement. |
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
| Palier | Hauteur de sortie | Tarif par seconde |
|---|
| 720p | ≤ 720px | ~0,013 $ |
| 1080p | 721–1080px | ~0,025 $ |
| 4K | > 1080px | ~0,10 $ |
Les vidéos avec une fréquence d’images supérieure à 48 ips coûtent 2x le tarif par seconde.
Exemples de tarification
| Entrée | Facteur de mise à l’échelle | Sortie | Durée | Coût estimé |
|---|
| 480p, 30 ips | 2x | 960p (palier 1080p) | 10 s | ~0,25 $ |
| 720p, 30 ips | 2x | 1440p (palier 4K) | 10 s | ~1,00 $ |
| 1080p, 30 ips | 2x | 2160p (palier 4K) | 30 s | ~3,00 $ |
| 360p, 24 ips | 4x | 1440p (palier 4K) | 10 s | ~1,00 $ |
| 480p, 60 ips | 2x | 960p (palier 1080p) | 10 s | ~0,50 $ |
Obtenir un devis
curl https://api.venice.ai/api/v1/video/quote \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "topaz-video-upscale",
"duration": "10",
"input_height": 720
}'
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
| Problème | Cause probable | Solution |
|---|
"Use upscale_factor instead of resolution" | resolution a été passé dans la requête | Supprimez resolution et utilisez upscale_factor à la place |
| Coût plus élevé que prévu | La vidéo d’entrée a une haute résolution ou une fréquence d’images élevée | Vérifiez les dimensions d’entrée avec le endpoint de devis. Une entrée 720p+ avec une mise à l’échelle 2x atterrit dans le palier de tarification 4K. |
| La tâche prend beaucoup de temps | Vidéo volumineuse ou longue | La mise à l’échelle est intensive en calcul. Les vidéos plus longues et les facteurs de mise à l’échelle plus élevés prennent proportionnellement plus de temps. |
"Insufficient balance" | Crédits du compte trop bas | Ajoutez des crédits sur venice.ai/settings/api |
