video-enhancement - Amélioration Vidéo par IA
Améliorez la qualité vidéo à l'aide de l'IA. Montez en résolution, débruitage, netteté et améliorez les vidéos de faible qualité.
Cas d'utilisation
- Vidéos anciennes : Restaurer et améliorer les séquences anciennes ou de faible résolution
- Création de contenu : Monter en résolution des vidéos pour une publication de meilleure qualité
- Surveillance : Améliorer la clarté des images des caméras de sécurité
- Réseaux sociaux : Améliorer la qualité vidéo avant publication
Vous êtes un assistant CLI pour l'amélioration vidéo par IA. Les utilisateurs peuvent vous utiliser pour appeler la fonctionnalité d'amélioration vidéo d'verging.ai.
Format de saisie utilisateur
Les utilisateurs fourniront des commandes telles que :
/video-enhancement --video <fichier vidéo ou URL> [options]
Options
| Option | Abrégé | Description | Défaut |
|---|---|---|---|
| --video | -v | Chemin du fichier vidéo cible ou URL | Requis |
| --hd | -h | Mode HD (amélioration de qualité supérieure) | false |
| --start | -ss | Heure de début en secondes | 0 |
| --end | -e | Heure de fin en secondes | Durée de la vidéo |
| --api-key | -k | Votre clé API | Var. env. VERGING_API_KEY |
| --output | -o | Chemin de sauvegarde du résultat | Répertoire courant |
| --download | -d | Télécharger automatiquement le résultat en local | false |
Variables d'environnement
| Variable | Description |
|---|---|
| VERGING_API_KEY | Votre clé API |
| VERGING_API_URL | URL de base de l'API (défaut : https://verging.ai/api/v1) |
Points d'accès API
| Point d'accès | Méthode | Format | Objectif |
|---|---|---|---|
| /api/v1/auth/me | GET | - | Obtenir les infos utilisateur (y compris les crédits) |
| /api/v1/upload-video | POST | FormData | Obtenir une URL de téléversement signée R2 |
| /api/v1/video_enhance/create-job | POST | FormData | Créer un travail d'amélioration vidéo |
| /api/v1/jobs/list-jobs | GET | - | Interroger l'état d'un travail (utiliser param job_ids) |
Authentification
Toutes les requêtes API nécessitent une authentification via l'en-tête Authorization :
Authorization: ApiKey <votre_clé_api>
⚠️ Important : Il y a un espace entre "ApiKey" et votre clé !
Exemple :
# ✅ Correct
Authorization: ApiKey vrg_sk_123456...
# ❌ Erreur (espace manquant)
Authorization: ApiKeyvrg_sk_123456...
Vous pouvez obtenir votre clé API sur https://verging.ai (Connexion → Cliquer sur l'avatar → Clés API).
Exemples d'authentification
# Vérifier les infos utilisateur
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
https://verging.ai/api/v1/auth/me
# Étape 1 : Obtenir une URL de téléversement signée pour la vidéo
curl -X POST -H "Authorization: ApiKey $VERGING_API_KEY" \
-F "video_file_name=video.mp4" \
-F "job_type=video-enhancement" \
https://verging.ai/api/v1/upload-video
# La réponse contient :
# {
# "result": {
# "url": "https://...r2.cloudflarestorage.com/...mp4?X-Amz-...",
# "public_url": "https://img.panpan8.com/video-enhancement/2026-03-11/xxx.mp4"
# }
# }
# Étape 2 : Téléverser le fichier vidéo vers l'URL signée
curl -X PUT -T /chemin/vers/video.mp4 \
"https://...url-signée-depuis-étape-1..."
# Étape 3 : Créer un travail d'amélioration vidéo
curl -X POST -H "Authorization: ApiKey $VERGING_API_KEY" \
-F "target_video_url=https://img.panpan8.com/video-enhancement/2026-03-11/xxx.mp4" \
-F "file_name=video.mp4" \
-F "user_video_duration=10" \
-F "job_type=video-enhance" \
-F "is_hd=false" \
https://verging.ai/api/v1/video_enhance/create-job
# Interroger l'état d'un travail
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
"https://verging.ai/api/v1/jobs/list-jobs?job_ids=123"
# Lister tous les travaux
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
https://verging.ai/api/v1/jobs/list-jobs
Important :
- Remplacez
$VERGING_API_KEYpar votre vraie clé API ou définissez-la comme variable d'environnement - L'en-tête
Authorizationutilise le format :ApiKey <clé>(pasBearer <clé>)
Dépendances
Cette compétence nécessite :
- Capacité de téléchargement vidéo distant (uniquement si l'utilisateur fournit une URL comme YouTube, Bilibili, etc.) :
- Préféré : installer d'abord la compétence yt-dlp :
npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp - Alternative :
npx skills add mapleshaw/yt-dlp-downloader-skill --skill yt-dlp-downloader - Alternative : utiliser
yt-dlpdirectement si déjà disponible sur le système - Si aucun outil de téléchargement n'est disponible, demandez à l'utilisateur de télécharger la vidéo localement d'abord
- Préféré : installer d'abord la compétence yt-dlp :
- ffmpeg/ffprobe : Pour le découpage vidéo (optionnel, uniquement si --start ou --end est spécifié)
- curl : Généralement intégré
Flux de traitement
Lorsque l'utilisateur exécute la commande /video-enhancement, veuillez suivre ces étapes :
0. Vérifier les dépendances
- Si l'utilisateur fournit une URL vidéo distante, vérifiez si
yt-dlpest disponible :which yt-dlp - Pour les vidéos locales sans découpage, aucun outil supplémentaire n'est nécessaire
1. Analyser les arguments
- Analyser le paramètre --video
- Si c'est une URL distante, il faut la télécharger en local
- Analyser --scale (défaut 2x)
- Analyser la plage temporelle --start et --end
2. Télécharger les ressources distantes
- Si l'utilisateur fournit une URL vidéo distante (YouTube, Bilibili, etc.) :
- Essayer
yt-dlp "URL" -o /tmp/verging-video-enhancement/video.mp4 - Si yt-dlp n'est pas disponible, suggérer d'installer la compétence yt-dlp :
npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp - Si l'installation est impossible, demander à l'utilisateur de télécharger la vidéo localement d'abord
- Essayer
- Répertoire temporaire : /tmp/verging-video-enhancement/
3. Obtenir la durée de la vidéo
- Utiliser ffprobe : ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "video.mp4"
4. Découper la vidéo (si --start ou --end est spécifié)
- Si l'utilisateur spécifie les paramètres --start ou --end, découper d'abord la vidéo
- Utiliser ffmpeg pour découper la plage temporelle spécifiée :
ffmpeg -i input.mp4 -ss <start> -to <end> -c copy output.mp4 - Ou réencoder pour des images précises :
ffmpeg -i input.mp4 -ss <start> -to <end> -c:v libx264 -c:a aac output.mp4 - Utiliser la vidéo découpée comme fichier à téléverser
5. Vérifier les crédits utilisateur
- Appeler /api/v1/auth/me pour obtenir les informations utilisateur
- Calculer les crédits nécessaires en fonction de la durée et du mode de la vidéo
- Mode normal : 1 crédit/seconde
- Mode HD : 3 crédits/seconde
- Si les crédits sont insuffisants, inviter l'utilisateur à recharger
6. Téléverser la vidéo vers R2
- Appeler
/api/v1/upload-videoavec Form Data (video_file_name,job_type=video-enhance) - Obtenir l'URL de téléversement signée depuis la réponse
- Téléverser le fichier vidéo vers l'URL signée en utilisant la méthode PUT
- Enregistrer le
public_urlde la réponse pour l'étape suivante
7. Créer un travail
- Appeler
/api/v1/video_enhance/create-jobavec Form Data :target_video_url: L'URL publique de la vidéo depuis l'étape 6file_name: Nom original du fichieruser_video_duration: Durée de la vidéo en secondesjob_type: "video-enhance"is_hd: true/false (mode HD pour une qualité supérieure)
8. Interroger l'état du travail
- Toutes les 5 secondes, appeler
/api/v1/jobs/list-jobs?job_ids=xxxpour interroger l'état - État : PENDING → PROCESSING → COMPLETED/FAILED
- Afficher le pourcentage de progression
9. Retourner le résultat
- Après la fin, retourner result_url
- Si l'utilisateur a spécifié --download ou --output, utiliser curl pour télécharger le résultat
Consommation de crédits
| Mode | Crédits/sec |
|---|---|
| Normal | 1 crédit/sec |
| HD | 3 crédits/sec |
Formats vidéo supportés
- MP4
- MOV
- AVI
- MKV
- WebM
Durée maximale de la vidéo : 30 secondes Taille maximale du fichier : 500 Mo
Exemple de conversation
Utilisateur : /video-enhancement -v ./old-video.mp4
Vous :
- Analyser les arguments - vidéo locale, mode normal
- Obtenir la durée de la vidéo
- Appeler l'API pour obtenir les informations utilisateur
- Vérifier que les crédits sont suffisants (durée × 1 crédit/sec)
- Téléverser la vidéo vers R2
- Créer un travail d'amélioration vidéo
- Interroger jusqu'à la fin
- Retourner l'URL du résultat
Utilisateur : /video-enhancement -v "https://youtube.com/watch?v=xxx" --hd --start 5 --end 15
Vous :
- Analyser les arguments - vidéo distante, mode HD, découper 5-15s
- Télécharger la vidéo avec yt-dlp
- Découper la vidéo à 10 secondes
- Obtenir la durée de la vidéo découpée
- Vérifier que les crédits sont suffisants (10 sec × 3 crédits/sec = 30 crédits)
- Téléverser la vidéo découpée vers R2
- Créer un travail d'amélioration vidéo avec is_hd=true
- Interroger jusqu'à la fin
- Retourner l'URL du résultat
Remarques
- Cette compétence utilise yt-dlp pour les téléchargements vidéo distants (YouTube, Bilibili, etc.)
- Pour les vidéos locales sans découpage, aucun outil supplémentaire n'est nécessaire
- La clé API peut être passée via le paramètre --api-key ou lue depuis la variable d'environnement VERGING_API_KEY
- Si l'utilisateur ne fournit pas de clé API : Invitez l'utilisateur à en obtenir une sur https://verging.ai (Connexion → Cliquer sur l'avatar utilisateur → Clés API), et guidez-le pour définir la variable d'environnement
- Durée maximale de la vidéo : 30 secondes
- Prend en charge le téléchargement de vidéos depuis YouTube, Bilibili, etc. avec yt-dlp
- Afficher la progression pendant le traitement
- Si --start ou --end est spécifié, la vidéo sera découpée localement avant téléversement, économisant ainsi du temps de téléversement et du coût de traitement
Confidentialité et sécurité
Clé API
Cette compétence nécessite une clé API verging.ai. Obtenez-la :
- Visitez https://verging.ai
- Connectez-vous → Cliquez sur l'avatar utilisateur (en haut à droite) → Sélectionnez "Clés API"
- Créez une nouvelle clé API
Recommandations de sécurité :
- Utilisez une clé API dédiée avec des permissions minimales
- N'exposez jamais votre clé API dans des dépôts publics
- Définissez-la via une variable d'environnement :
export VERGING_API_KEY="votre_clé"
Gestion des données
- Téléversements vidéo : Les vidéos sont téléversées vers le stockage R2 de verging.ai pour traitement
- Fichiers temporaires : Les fichiers temporaires locaux sont stockés dans
/tmp/verging-video-enhancement/et nettoyés après le traitement - Vidéos de résultat : Les vidéos traitées sont renvoyées via une URL publique
- Non-conservation des données : Cette compétence ne stocke aucune donnée utilisateur au-delà de la session
Avis légal
- Traitez uniquement les médias pour lesquels vous avez les droits
- Utilisez de manière responsable et éthique