PeakCut en pratique : construire votre propre outil de montage vidéo court avec IA

Ce qui prend le plus de temps dans les vidéos courtes n'est pas le montage, mais trouver les quelques dizaines de secondes qui valent la peine d'être publiées parmi une à deux heures de direct ou de longue vidéo. PeakCut automatise cette chaîne de traitement : reconnaissance vocale locale, sélection des moments forts par l'IA, découpe automatique en format vertical 9:16 avec sous-titres mot à mot. Ce qui est le plus attractif, c'est que tout le processus peut être entièrement exécuté sur votre propre ordinateur, les données vidéo et audio ne sortent pas de la machine.

Son flux de travail est très direct : transcrire l'audio, laisser l'IA décider quels segments peuvent retenir l'attention d'un inconnu, puis utiliser FFmpeg pour rendre des vidéos courtes verticales avec sous-titres. La transcription utilise les modèles sherpa-onnx et Parakeet, entièrement en local ; l'IA ne s'occupe que de sélectionner les segments et d'écrire les titres, vous pouvez utiliser n'importe quel fournisseur, les interfaces compatibles avec OpenAI sont toutes acceptées.

Si vous ne voulez pas utiliser l'interface officielle de ChatGPT, Defapi est une bonne option. Son prix est la moitié de celui de l'officiel, et tous les modèles sont fondamentalement compatibles avec les protocoles principaux comme v1/chat/completions, v1/messages, v1beta/models/, donc le fournisseur personnalisé de PeakCut peut s'y connecter directement, et la configuration est exactement la même que l'étape 3 ci-dessous.

Dépendances principales et environnement

Avant de commencer, vérifiez ces éléments :

  • Python 3.10+ : environnement d'exécution du programme principal.
  • FFmpeg : tous les traitements vidéo et audio en dépendent. Sur Windows, utilisez winget install Gyan.FFmpeg, sur macOS brew install ffmpeg, sur Linux sudo apt install ffmpeg.
  • Réseau et stockage : au premier démarrage, vous devrez télécharger environ 480 Mo de modèles vocaux. Les fichiers vidéo eux-mêmes peuvent être volumineux, prévoyez au moins 20 Go d'espace disque.
  • Clé IA (facultatif) : vous pouvez l'utiliser sans configuration, auquel cas PeakCut sélectionnera les segments selon le volume sonore, mais sans titres générés par IA.

PeakCut recommande de placer le projet dans un chemin fixe, par exemple C:\peakcut (Windows) ou ~/peakcut (macOS/Linux). Évitez les répertoires temporaires, sur Windows un chemin trop profond peut entraîner un échec de chargement des modèles vocaux.

Arborescence du projet

peakcut/
├── studio/                  # Code principal du serveur
│   ├── server.py            # Point d'entrée FastAPI
│   ├── ai.py                # Couche d'adaptation des services IA (ajoutez des fournisseurs ici)
│   ├── transcribe.py        # Transcription vocale locale
│   ├── jobs.py              # Pipeline des tâches de montage
│   ├── render.py            # Rendu des sous-titres et composition vidéo
│   └── fonts/               # Fichiers de polices pour les sous-titres
├── web/                     # Pages front-end (HTML/CSS/JS pur)
├── deploy/                  # Configuration de déploiement Docker
├── tests/                   # Tests automatisés
├── requirements.txt         # Dépendances Python
├── .env.example             # Modèle de variables d'environnement
└── Dockerfile

Étapes pas à pas

1. Cloner le dépôt et installer les dépendances

git clone https://github.com/haziqahmedqasmi/peakcut.git ~/peakcut
cd ~/peakcut
pip install -r requirements.txt

Il est recommandé d'utiliser un environnement virtuel pour éviter de polluer les paquets Python globaux.

2. Démarrer le service local

python -m studio.server

Le premier démarrage téléchargera automatiquement les modèles vocaux (environ 480 Mo), il faudra attendre un peu. Lorsque vous voyez une sortie comme Uvicorn running on http://127.0.0.1:8765, cela signifie que le service est opérationnel.

Ouvrez le navigateur à http://127.0.0.1:8765, vous accédez directement à la console sans connexion.

3. Configurer le service IA

Allez dans la page Settings → AI. Ici, choisissez votre fournisseur de services IA. L'IA de PeakCut est responsable de deux choses : décider quels segments méritent d'être découpés et écrire des titres pour les segments. Elle a besoin d'un modèle de chat capable de retourner du JSON, et non d'un service de transcription vocale—la transcription se fait toujours localement.

Dans le menu déroulant, choisissez Custom (OpenAI-compatible), un champ de saisie Base URL apparaît. Remplissez l'adresse de votre fournisseur, collez votre clé API dans le champ Key, saisissez manuellement un nom de modèle de chat prenant en charge la sortie JSON, puis cliquez sur Find models pour récupérer la liste des modèles disponibles (si le fournisseur le supporte), et enfin Save and test.

Par exemple, Defapi fournit une interface compatible OpenAI, à moitié prix par rapport à l'officiel. Configuration :

  • Base URL : https://api.defapi.org/v1
  • Key : obtenue dans la console de la plateforme Defapi
  • Modèle : saisissez un ID de modèle de chat prenant en charge la sortie JSON, par exemple your-model-id (l'ID exact dépend de la liste dans le backend de votre compte)

Defapi est compatible avec les protocoles principaux v1/chat/completions, v1/messages, v1beta/models/, donc le fournisseur personnalisé de PeakCut peut s'y connecter directement.

Note : si vous avez précédemment configuré des paramètres IA via le fichier .env, les configurations sauvegardées dans la console écraseront les réglages du .env. Si vous souhaitez utiliser le .env, les variables correspondantes sont :

PEAKCUT_AI_PROVIDER=custom
PEAKCUT_AI_MODELS=your-model-id
PEAKCUT_AI_KEY=your-key
PEAKCUT_AI_BASE_URL=https://api.defapi.org/v1

4. Importer des vidéos

En haut de la page d'accueil, il y a une zone de collage qui prend en charge les liens YouTube, Twitch, Kick, ou vous pouvez téléverser directement un fichier vidéo local.

Dans Options, vous pouvez définir le nombre de segments générés (1-20), les durées minimale/maximale (minimum 5 secondes, maximum 180 secondes), le style des sous-titres (Bounce/Hype/Clean), la mise en page (remplissage flou/zoom/recadrage/jeu avec caméra), la résolution (720p/1080p), et même limiter le traitement à une certaine partie de la vidéo.

Il y a une option appelée Generate captions, activée par défaut. Les sous-titres sont surlignés mot par mot, ce qui nécessite que le modèle vocal produise des résultats de reconnaissance avec horodatage. Le modèle par défaut supporte le mieux l'anglais ; si vous utilisez une autre langue, vous devrez changer de modèle, ce qui est expliqué dans la section de dépannage plus loin.

Remplissez le lien, cliquez sur Make clips pour commencer le traitement.

5. Filtrer les segments et ajuster les sous-titres

Une fois le traitement terminé, allez dans la page de détails de la vidéo pour voir tous les segments générés. Pour chaque segment, vous pouvez :

  • Prévisualiser : voir si le résultat est satisfaisant
  • Ajuster le début/fin : affiner en glissant la barre temporelle
  • Modifier les sous-titres : corriger manuellement les mots si la reconnaissance a fait des erreurs
  • Changer le style des sous-titres : basculer librement entre les trois styles

PeakCut génère pour chaque segment une image de couverture et un titre accrocheur (écrit par l'IA). Si le titre ne vous convient pas, vous pouvez le modifier directement.

6. Exporter la vidéo courte verticale

Une fois les segments validés, cliquez sur Download pour exporter. Le rendu est effectué par FFmpeg, produisant en sortie un format vertical 9:16, avec les sous-titres incrustés dans l'image.

Si vous avez configuré des connexions de comptes YouTube, Instagram ou TikTok, vous pouvez également publier directement à partir d'ici. Pour une utilisation sur une seule machine, il est recommandé de télécharger puis de transférer manuellement.

Dépannage des problèmes courants

FFmpeg manquant
Après le démarrage, la console indique que FFmpeg est introuvable. Vérifiez que ffmpeg -version fonctionne correctement ; sinon, réinstallez-le et assurez-vous qu'il est dans le PATH.

Échec du téléchargement des modèles vocaux
Si le téléchargement du modèle est interrompu au premier démarrage, supprimez le dossier correspondant dans data/models/ et redémarrez le service pour le retélécharger. Si le réseau est instable, vous pouvez télécharger manuellement depuis Hugging Face et le placer dans le répertoire approprié.

L'IA configurée dans la console ne fonctionne pas
Vérifiez sur la page Settings → AI si la configuration est enregistrée. Les configurations enregistrées dans la console ont priorité sur le fichier .env ; si vous aviez précédemment défini des variables IA dans le .env, elles sont ignorées une fois que la console a enregistré. Pour revenir à la configuration .env, vous devez reselectionner le fournisseur dans la console puis enregistrer.

Erreur de format JSON de la réponse IA
Assurez-vous que l'ID du modèle correspond à un modèle de chat prenant en charge la sortie JSON. Certains modèles (en particulier les modèles de raisonnement purs) ne garantissent pas un JSON valide, essayez un autre modèle. Vous pouvez aussi consulter la page AI usage, qui contient les journaux détaillés des requêtes.

Langue des sous-titres incorrecte
Le modèle Parakeet par défaut ne prend en charge que l'anglais. Pour des vidéos en chinois, soit changez pour un modèle sherpa-onnx prenant en charge le chinois (il faut modifier ASR_MODEL_NAME dans studio/config.py), soit utilisez la transcription chinoise intégrée de YouTube (cette fonctionnalité est activée par défaut, elle privilégie le texte de transcription de YouTube).

Espace disque insuffisant
Le répertoire data/ stocke toutes les vidéos et tous les résultats générés. Avant de traiter de longues vidéos, vérifiez que l'espace disque est suffisant. Allez dans Settings → Storage pour voir le chemin de stockage actuel et l'espace restant, ou déplacez le répertoire de données vers un autre disque.

Lectures complémentaires / Directions avancées

PeakCut ne se contente pas de découper des vidéos déjà enregistrées ; il peut également enregistrer en temps réel pendant un direct et découper les moments forts. Créez un espace de travail pour chaque créateur, configurez la chaîne et il écoutera automatiquement, produisant des vidéos pendant le direct.

Pour la collaboration multi-utilisateurs ou le déploiement sur Internet, consultez DEPLOY.md : utilisez Docker pour exécuter l'application + PostgreSQL + Caddy avec HTTPS automatique, et prenez en charge l'inscription par e-mail et la connexion Google. Notez que pour le déploiement public, vous devez activer PEAKCUT_ACCOUNTS=1, sinon toute personne connaissant l'adresse pourra utiliser votre clé IA.

Connecter des comptes de médias sociaux (YouTube/Instagram/TikTok) nécessite d'enregistrer une application développeur sur chaque plateforme. Pendant la période d'examen de la plateforme, les vidéos téléversées seront par défaut en mode privé ; c'est une limitation de la plateforme, pas un problème de PeakCut.

Pour approfondir, studio/ai.py est le seul fichier qui interagit avec les services IA ; c'est là que vous ajoutez un nouveau fournisseur ou déboguez la logique des requêtes. Le code inclut également un ensemble de tests (python tests/run.py) ; après avoir modifié le code, exécutez-les pour éviter les régressions.