Communitygithub.com

ai-video-voice

Voix off et sous-titres pour une courte vidéo : synthèse TTS en une seule prise, synchronisation audio-image par durée réelle, minutage des sous-titres à partir de l'audio, mix normalisé à -14 LUFS. S'exécute après ai-video-render, avant la relecture.

Qu'est-ce que ai-video-voice ?

Cette compétence pour agent IA ajoute une voix off et des sous-titres à une vidéo muette déjà rendue (film.mp4). Elle synthétise la voix en une seule prise continue pour éviter les coutures audibles, synchronise l'audio avec la vidéo en utilisant la durée réelle de la voix plutôt qu'un étirement temporel, et génère les sous-titres à partir de l'audio (transcription ou détection de silence). Le mix final est normalisé à -14 LUFS. Supporte les configurations de voix personnelles, mais signale les erreurs sans changement silencieux. Fonctionne avec Claude Code, Cursor, Codex ou d'autres agents compatibles. Utile pour les chaînes de production vidéo automatisées où la voix off et les sous-titres sont ajoutés après le rendu et avant la relecture.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LaomaiAI/ai-video-skills/tree/HEAD/skills/04-voice

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

ai-video-voice: Voix off et sous-titres

Quand l'utiliser

La vidéo muette (film.mp4) existe. Cette compétence ajoute la voix off, les sous-titres et le mix final. Elle ne modifie jamais l'image.

1. Vérifier d'abord la configuration de la voix

Exécutez la vérification de la configuration TTS avant la synthèse (par exemple une commande doctor si l'outil TTS en fournit une). Signalez à l'utilisateur toute configuration manquante ; ne passez pas silencieusement à une voix différente.

  • Si l'utilisateur a demandé une voix personnelle et que sa configuration est manquante ou défectueuse, suspendez seulement la voix off concernée. Ne la remplacez pas silencieusement par une autre voix.
  • Les configurations de voix personnelles, enregistrements, clips de référence et poids du modèle restent dans un répertoire privé. Ils n'entrent jamais dans ce dépôt.

2. Synthétiser en une seule prise entière

  • Synthétisez la voix off en une seule prise entière, pas phrase par phrase. La couture crée des raccords audibles et une dérive.
  • Si le modèle vocal ou le clip de référence change, générez une nouvelle version de la voix off. N'écrasez jamais l'ancien fichier audio.

3. La synchronisation audio-image utilise la durée réelle

  • Synchronisez par la durée réelle de la voix off. N'étirez jamais temporellement l'audio pour l'adapter à un plan.
  • Si la séquence est trop courte, maintenez la dernière image pour combler l'écart. Si la séquence est trop longue, coupez le segment le moins informatif.
  • Placez les actions fortes sur les temps forts. Déplacez les effets sonores du mouvement lui-même.

4. Les sous-titres suivent l'audio

  • Le minutage des sous-titres provient de l'audio, pas de l'estimation du script. Transcrivez avec un reconnaissance vocale quand il est disponible ; sans cela, utilisez le script avec détection de silence (l'erreur peut atteindre 0,4 seconde).
  • Corrigez les erreurs de reconnaissance par rapport au script. Coupez les phrases de début et de fin qui appartiennent aux voisins.
  • Livrez captions.srt avec le film. Si le film est remonté pour un éditeur qui ajoute ses propres sous-titres, livrez également une vidéo sans sous-titres plus le fichier .srt.

5. Mix

  • Normalisez l'audio mixé à -14 LUFS.
  • Gardez la musique, la voix off et les effets sonores sur une seule timeline avec l'image.
  • Vérifiez le pic audio et le décodage complet avant de passer à la relecture.

Contrat de sortie

  • voiceover.wav (ou .mp3), une seule prise entière.
  • captions.srt.
  • mix-report.md (durée, pic, LUFS, source des sous-titres et marge d'erreur).

Règles

  • Une configuration vocale manquante bloque uniquement la voix off. Elle ne bloque jamais le travail sur le script ou l'image.
  • Ne prétendez jamais qu'un fichier de sous-titres est exact lorsqu'il provient de la détection de silence ; indiquez la marge d'erreur dans le rapport de mix.
  • Pas de téléchargement ni de déploiement audio sans autorisation de sortie.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Skills associés