Guide d'utilisation
Utiliser topaz-upscale/video via l'API HiAPI : un flux de travail pour améliorer la qualité des vidéos courtes
Interpolation d'images, réglages d'amélioration et une requête HiAPI exploitable pour une vidéo verticale
Sur cette page
Pourquoi les vidéos courtes méritent leur propre stratégie de rehaussement de qualité
Les vidéos courtes verticales — ces clips de quinze à soixante secondes qui occupent l'écran d'un téléphone — échouent différemment des vidéos longues. Un documentaire horizontal peut masquer un manque de netteté grâce au flou de mouvement et aux détails d'arrière-plan. Un clip vertical est regardé avec une attention totale, recadré dans un cadre étroit et souvent recompressé par la plateforme d'hébergement. La moindre faiblesse du fichier source est amplifiée plutôt que pardonnée.
Cela change le problème que doit résoudre le rehaussement de qualité. Avec des séquences longues, il suffit souvent d'améliorer un seul master, et c'est terminé. Avec une vidéo courte, le fichier source a généralement déjà été encodé une ou deux fois pour le mobile, puis livré à une plateforme qui va l'encoder à nouveau. L'objectif n'est pas seulement un chiffre de résolution plus élevé, mais un fichier capable de survivre à la compression suivante : bords nets, mouvement stable, détail homogène sur toute l'image.
Considérez donc cela comme une chaîne de traitement, et non comme un simple appel :
- Normaliser la source — couper exactement aux points de montage, verrouiller le rapport d'aspect et fixer la fréquence d'images avant le rehaussement.
- Rehausser et améliorer avec
topaz-upscale/video, en réglant avec soin l'interpolation d'images et l'amélioration. - Vérifier que la sortie correspond à la source avant de publier, car le rehaussement, en accentuant l'image, peut aussi facilement lisser les textures.
Chaque étape a ses propres modes d'échec. Couper au mauvais endroit gaspille du temps de traitement. Une interpolation imprudente crée des mouvements artificiels. Sauter la vérification envoie directement des défauts au public. Le reste de ce guide détaille chaque décision dans l'ordre, puis présente une requête HiAPI exploitable que vous pouvez adapter à vos propres médias.

Ce que fait topaz-upscale/video sur HiAPI
topaz-upscale/video est le point de terminaison de rehaussement de qualité vidéo du catalogue de modèles HiAPI. Vous lui envoyez un média vidéo et des réglages, et il renvoie une vidéo rehaussée. C'est tout le contrat — le reste relève de la configuration.
Voici comment le situer dans votre chaîne de traitement :
- Entrée : une vidéo accessible par l'API, généralement l'URL de votre fichier source. Vous avez déjà effectué la normalisation du rapport d'aspect et le montage avant cette étape ; le modèle ne fait que rehausser ce que vous lui donnez.
- Traitement : le service traite votre clip selon les réglages de rehaussement et d'amélioration que vous spécifiez, y compris l'interpolation d'images lorsque vous l'activez.
- Sortie : un média vidéo rehaussé référencé dans le résultat de la tâche, que vous téléchargez pour l'étape de publication.
Quelques remarques pratiques pour les développeurs :
- Il s'agit d'une tâche, pas d'une réponse synchrone. Le traitement vidéo prend un temps proportionnel à la durée et aux réglages ; l'API renvoie donc d'abord une tâche (à interroger ou à attendre) plutôt que le fichier final.
- Le temps d'exécution croît avec la durée du clip. Des clips plus longs ou des réglages plus lourds consomment plus de temps de traitement. Les vidéos courtes sont avantagées sur ce point — les itérations coûtent peu.
- Les paramètres font foi dans la documentation en ligne. Les noms exacts des paramètres de
topaz-upscale/video, leurs valeurs acceptées et leurs valeurs par défaut sont définis par la documentation actuelle du modèle HiAPI. Ne supposez pas qu'un paramètre existe parce qu'un outil de bureau ou un autre fournisseur utilise un nom similaire. Consultez la page du modèle avant de construire.
Le modèle occupe exactement une place dans votre pipeline : après la normalisation, avant la vérification et la publication. Gardez cette frontière nette et le reste du flux de travail demeure simple.

Planifier l'interpolation d'images pour le rythme des vidéos courtes
L'interpolation d'images synthétise des images intermédiaires pour augmenter la fréquence d'images effective — par exemple, transformer une source à 24 ou 30 fps en une sortie plus fluide à 60 fps. Sur des vidéos courtes, on est tenté de l'activer partout, car un mouvement fluide semble plus haut de gamme. Cette intuition est souvent erronée.
Quand l'interpolation aide
- Mouvements de caméra rapides ou filés. Les clips verticaux utilisent souvent des mouvements rapides qui saccadent à faible fréquence d'images. L'interpolation permet de lisser les mouvements de balayage.
- Séquences au ralenti ou à vitesse variable. Si vous filmez à faible fréquence d'images puis ralentissez, l'interpolation comble les lacunes et réduit les saccades.
- Fréquence d'images source déjà proche de la cible. Passer de 30 fps à 60 fps est une amélioration modérée et prévisible.
Quand cela n'ajoute que du coût sans bénéfice visible
- Plans fixes de prise de parole. Si l'image change à peine, les images interpolées sont presque identiques aux images voisines. Vous payez du temps d'exécution pour rien.
- Sources déjà à haute fréquence d'images. Interpoler de 60 fps à 120 fps ne survivra probablement pas au réencodage de la plateforme de toute façon.
- Sources très floues en mouvement ou de très faible qualité. L'interpolation devine un mouvement qu'elle ne distingue pas, et ces suppositions se manifestent par des distorsions ou des images fantômes près des bords.
Un réglage par défaut prudent
Pour la plupart des travaux sur vidéos courtes, commencez avec l'interpolation désactivée, rehaussez à la fréquence d'images source, puis vérifiez le résultat. Si le mouvement saccade, activez l'interpolation à la fréquence cible la plus basse qui résout le problème. Ne changez qu'une variable à la fois, afin de savoir ce qui a apporté l'amélioration — ou le défaut.
Gardez aussi à l'esprit que l'interpolation interagit avec le temps d'exécution. Chaque image interpolée représente du travail supplémentaire. La différence est négligeable sur un clip de quinze secondes ; elle s'accumule sur des centaines ou des milliers de lots. Mesurez sur un clip représentatif avant d'appliquer un réglage à toute une file.
Choisir les réglages d'amélioration sans deviner
Les réglages d'amélioration contrôlent la force avec laquelle le modèle accentue, débruite et restaure les détails. Il n'existe pas de configuration « optimale » universelle, car la bonne quantité dépend de la qualité de votre source et de l'endroit où le clip sera publié.
Partir de la source, pas de la cible
Avant de toucher au moindre réglage, posez deux questions à l'entrée :
- Quelle est la propreté de la source ? Des rushes caméra nets supportent une amélioration légère. Une source fortement recompressée ou à faible débit nécessite plus de retenue, car l'amélioration amplifie les artefacts de compression en même temps que les détails réels.
- Que va-t-elle subir sur la plateforme ? Chaque grande plateforme de vidéos courtes réencode les contenus téléversés. Une accentuation agressive qui semble bonne sur votre moniteur peut devenir résonance et halos après le second encodage.
Un cadre de décision pratique
- Rushes de haute qualité, rehaussement modéré : utilisez une amélioration conservatrice. Laissez l'upscaler faire le travail et maintenez l'accentuation au minimum pour que les textures survivent à la compression de la plateforme.
- Sources molles ou déjà compressées : privilégiez d'abord le débruitage, puis une accentuation modérée. Une accentuation excessive sur une source bruitée produit des bords durs et cassants, plus désagréables que le manque de netteté initial.
- Texte, visages et détails de produit : les clips courts reposent souvent sur des sous-titres lisibles et des visages nets. Vérifiez spécifiquement ces zones — une amélioration bénéfique aux paysages peut rendre le texte fin flou.
- Clips riches en mouvement : associez une amélioration conservatrice à votre décision sur l'interpolation. Une accentuation forte combinée à l'interpolation est la source la plus fréquente d'artefacts de scintillement.
Vérifier les options réellement disponibles
Les paramètres exacts d'amélioration, leurs plages acceptées et les éventuels préréglages sont définis par la documentation en ligne de HiAPI pour topaz-upscale/video. Les noms de paramètres et les valeurs par défaut peuvent changer et ne correspondent pas nécessairement à ceux d'autres outils que vous avez utilisés. Lisez la page du modèle, définissez explicitement les valeurs dans la requête et évitez de vous fier à des valeurs par défaut mémorisées. En cas de doute, exécutez deux réglages sur le même clip court et comparez — c'est moins coûteux que de deviner sur tout un lot.
Une requête HiAPI topaz-upscale/video exploitable
Avant d'écrire la requête, définissez deux variables d'environnement pour que votre clé n'entre jamais dans la gestion de code source :
export HIAPI_API_KEY="your_api_key_here"
export SOURCE_VIDEO="https://your-bucket.example.com/clips/cut_vertical.mp4"
Soumettez maintenant une tâche. La structure ci-dessous donne le schéma : faire pointer la requête vers le modèle, transmettre l'URL de la vidéo source et inclure explicitement vos réglages de rehaussement et d'interpolation. Consultez la documentation du modèle HiAPI pour les noms exacts des paramètres et les valeurs acceptées de topaz-upscale/video, puis ajustez le corps de la requête en conséquence.
curl -X POST "https://api.hiapi.ai/v1/models/topaz-upscale/video/jobs" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"video_url": "'"$SOURCE_VIDEO"'"
},
"settings": {
"upscale": {
"target_resolution": "1080p"
},
"frame_interpolation": {
"enabled": false
},
"enhancement": {
"strength": "conservative"
}
}
}'
À quoi vous attendre et comment réagir :
- La réponse contient un identifiant de tâche et un état. Conservez l'ID de tâche — vous en aurez besoin pour récupérer le résultat.
- Interrogez ou attendez. Les clips courts se terminent vite, mais écrivez toujours votre client pour gérer l'état en attente plutôt que de supposer que la première lecture est terminée.
- Récupérez le média de sortie depuis la tâche terminée, téléchargez-le dans votre propre stockage, puis ajoutez-le à la file de publication.
- Soumettez à nouveau, ne modifiez pas. Pour tester l'interpolation activée, envoyez une nouvelle tâche avec l'indicateur modifié. Ne gardez qu'une seule variable par tâche pour que la comparaison soit honnête.
La première requête est aussi votre validation la plus rapide : exécutez-la sur votre propre clip, avec ses vrais rapport d'aspect et durée, avant de construire une quelconque automatisation autour.

Vérifier le résultat et intégrer le rehaussement dans le pipeline
Un fichier rehaussé n'est pas automatiquement un meilleur fichier. La vérification est l'étape qui transforme un appel de modèle en flux de travail fiable.
Ce qu'il faut vérifier
- Bords et détails fins. Agrandissez le texte, les visages et les bords nets. Cherchez les halos, la résonance ou les textures lissées absents du fichier source.
- Cohérence du mouvement. Regardez les séquences à mouvement rapide à vitesse normale. Les artefacts d'interpolation apparaissent sur une image isolée sous forme de distorsion ou d'image fantôme — mettez en pause et examinez image par image.
- Couleur et exposition. Vérifiez que la sortie ne présente aucun décalage de teinte ou de luminosité ; l'amélioration peut modifier subtilement le contraste.
- Audio et durée. Assurez-vous que le clip a la même longueur et que la piste audio est complète à la milliseconde près. Une piste audio qui dérive après réencodage casse la synchronisation des sous-titres.
- Après la compression de la plateforme. Téléversez une copie de test en privé et vérifiez la version réencodée, car c'est ce que le public verra réellement.
Où le placer dans le pipeline
Un pipeline propre pour vidéos courtes se présente ainsi :
- Monter et exporter le montage final à sa résolution native et à une fréquence d'images stable.
- Téléverser la source dans un stockage accessible par l'API.
- Soumettre la tâche de rehaussement avec des réglages explicites, et consigner l'ID de tâche avec le clip.
- Télécharger et vérifier la sortie à l'aide des contrôles ci-dessus.
- Publier — directement ou via une file de publication planifiée multicanale.
Deux remarques opérationnelles. Conservez le fichier source d'origine ; ne l'écrasez jamais avec la version rehaussée, car vous voudrez le réexécuter avec d'autres réglages. Et consignez les réglages de chaque clip, afin que lorsqu'une sortie semble incorrecte, vous puissiez retracer exactement la configuration qui l'a produite. Cette traçabilité vous permet d'ajuster les réglages au fil du temps plutôt que de deviner à chaque lot.
Coûts, limites et points à confirmer avant de passer à l'échelle
Avant d'acheminer du trafic de production vers topaz-upscale/video, confirmez les détails opérationnels dans la documentation actuelle du modèle HiAPI plutôt que de les supposer à partir d'autres outils.
- Base de facturation. Comprenez comment le modèle facture — par exemple selon la durée de sortie ou le palier de résolution — et consultez le panneau tarifaire en temps réel pour les chiffres actuels. Les prix peuvent changer, et c'est un élément qu'il ne faut jamais coder en dur à partir de sa mémoire ou d'un message de forum.
- Limites de durée et de taille de fichier. L'entrée a une durée et une taille maximales ; les vidéos courtes restent généralement bien en dessous, mais des lots incluant des sources plus longues peuvent dépasser. Vérifiez les plafonds avant de soumettre.
- Débit et concurrence. Le nombre de tâches que vous pouvez exécuter en parallèle et l'existence éventuelle de limites de débit déterminent la forme de votre file. Concevez votre client pour reculer et réessayer lorsqu'il reçoit une réponse de limite de débit.
- Comportement en cas de délai d'attente. Les tâches vidéo peuvent prendre plus de temps que les requêtes HTTP classiques. Confirmez l'intervalle d'interrogation recommandé et la fenêtre de rétention des tâches.
- Stabilité des paramètres. Considérez les réglages du modèle comme faisant partie d'un contrat en ligne. Lisez la documentation au moment de l'intégration et vérifiez-la à nouveau lorsque le comportement est inattendu.
Un bon schéma de montée en charge : validez un clip représentatif, mesurez son temps d'exécution et son coût réels, puis extrapolez de façon prudente en ajoutant une marge. Placez prix et limites dans la configuration plutôt que dans le code, afin que les mises à jour soient de simples changements de configuration sans déploiement.
Commencez par un clip sur topaz-upscale/video, vérifiez-le, puis passez à l'échelle — c'est le chemin le plus rapide vers un pipeline de rehaussement de qualité vidéo courte fiable.
Articles similaires
Voir tous les articles →-
Guide d'utilisation
Guide de prise en main de Tripo H3.1 : trois modes d'entrée, paramètres et choix tarifaires
Décision d'intégration et maîtrise des coûts de la génération 3D pour les développeurs
-
Guide d'utilisation
Générer des images de produits e-commerce avec qwen-image-2.1-turbo via l'API HiAPI
Workflow de visuels catalogue rapide pour développeurs : sortie PNG transparente et requête API exécutable
-
Guide d'utilisation
Générer des images de produits e-commerce avec gpt-image-2.5-sunburst/image-to-image via l'API HiAPI
Images de référence, remplacement d'arrière-plan, scènes de vie, et une requête HiAPI fonctionnelle