yyert123/shorts-voiceover

Shorts voiceover

Script en entrée, Short prêt à être téléchargé en sortie. Contrairement aux outils qui devinent le timing des sous-titres à partir de la longueur du texte, cette compétence transcrit la piste vocale terminée, donc chaque sous-titre apparaît exactement quand le mot est prononcé.

Quand l’utiliser

• « Transforme ce script / ces astuces / cette publication en Short (ou Reel, ou TikTok). »
• « Fais un short sans visage avec voix off et sous-titres. » « Utilise ma voix. »
• « Fais 5 shorts à partir de ces scripts » -> exécuter une fois par fichier de script.

Étapes

1. Vérifier que MIRAGEA_API_KEY est défini (ne jamais l’afficher). Voice : l’ID de voix Miragea de l’utilisateur, ou une URL publique d’un extrait de sa voix plus ses mots exacts. Suggérer export MIRAGEA_VOICE_ID=.... Ne cloner qu’une voix que l’utilisateur possède ou a le droit d’utiliser.

2. Écrire le script : un court paragraphe par scène, une ligne vide entre les scènes, 120‑170 mots au total pour un Short de 45‑60 s. Ouvrir avec un accroche dans la scène 1. Un @fichier facultatif au début d’une scène choisit son fond :

   Trois astuces rapides pour rendre n’importe quelle voix off professionnelle.
   
   @broll/bureau.mp4
   D’abord, enregistrez dans une petite pièce avec des meubles rembourrés. L’écho est plus difficile à corriger que le bruit.
   

3. Rendu :

   python3 scripts/short.py astuces.txt --voice ID_VOIX                       # fonds dégradés
   python3 scripts/short.py astuces.txt --media ./broll --music fond.mp3     # images/clips + musique de l’utilisateur
   

4. Donner à l’utilisateur video et srt à partir du JSON imprimé. Proposer des modifications : changer le texte d’une scène et réexécuter ; seule cette scène est re‑voisée et le reste provient du cache.

Ce qui est automatique

Étape	Comment
Voix	Chaque scène est voisée avec Miragea ; 0,18 s de respiration entre les scènes
Timing des sous-titres	La piste vocale terminée est transcrite par Miragea ; indices MAJUSCULES de 1‑3 mots, tiers inférieur
Images	Recadrées en 9 :16, zoom avant/arrière lent en alternance par scène
Clips	Recadrés en 9 :16, bouclés ou rognés à la durée de la scène, son d’origine supprimé
Pas de média	Dégradé animé (4 palettes, rotation)
Musique	Bouclée, à 30 %, ducking latéral sous la voix
Loudness	-14 LUFS intégré, -1 dBTP (cible Shorts/TikTok/Reels)
Réexécutions	Voix par scène et transcription mises en cache ; les scènes inchangées sont gratuites

Options

Option	Défaut	Description
--voice ID / --ref-url URL --ref-text TEXTE	env	Voix Miragea sauvegardée, ou clonage à partir d’un extrait public
--media DOSSIER	aucun	Images/clips pour les scènes sans @fichier, dans l’ordre du nom
--music FICHIER	aucun	Musique de fond, ducking automatique
--lowercase	désactivé	Sous-titres en casse de phrase
--no-captions	désactivé	Ignorer les sous-titres (pas de coût de transcription)
--model	expressive	ou standard
-o FICHIER	SCRIPT.short.mp4	Chemin de sortie

Coût et limites

Voix : par caractère (un Short de 150 mots fait ~850 caractères). Timing des sous-titres : 3 points par seconde de la voix terminée (~75 points pour 25 s) ; mis en cache ensuite. Tarifs en direct : GET https://miragea.ai/v1/capabilities. Les scènes doivent faire moins de 2 000 caractères. Un avertissement est affiché au-dessus de 3 minutes (limite des Shorts YouTube).

Dépannage

• media file not found -> les chemins après @ sont relatifs au script ou au dossier --media.
• No such filter: gradients -> ffmpeg est antérieur à 6.1 ; mettre à jour, ou passer --media avec des images.
• 401 clé erronée, 402 recharger sur miragea.ai, 429 attendre et réexécuter (rien en cache n’est refacturé).

N’utilisez que de la musique et des séquences dont vous possédez les droits. Voir examples/ pour un véritable script et son résultat.