opcop/reference-driven-cinematic-video-skill

Que fait reference-driven-cinematic-video-skill ?

Compétence Codex pour créer des vidéos produit cinématographiques avec enregistrement utilisateur ou API vocale, narration par défaut, sous-titres et contrôles qualité FFmpeg.

Aperçu

Cette compétence permet de générer des vidéos produit de haute qualité en suivant une référence cinématographique. Elle supporte deux modes de narration :

• Enregistrement utilisateur : L'utilisateur fournit un fichier audio ou une URL.
• API vocale : Utilisation d'une API de synthèse vocale (par exemple, ElevenLabs).

Si aucun des deux n'est fourni, une narration par défaut est utilisée. Les sous-titres sont générés automatiquement via Whisper ou un service équivalent. FFmpeg applique des contrôles qualité (résolution, débit, codecs) avant de finaliser la vidéo.

Prérequis

• FFmpeg installé localement ou accessible via PATH.
• Clé API pour le service vocal (si utilisation de l'API).
• Dépendances Python : opencv-python, whisper, moviepy, requests.

Utilisation

codex run opcop/reference-driven-cinematic-video-skill --input "chemin/vers/la/reference.mp4" --narration "chemin/vers/narration.mp3"

Options :

• --input : Chemin vers la vidéo de référence.
• --narration : Chemin vers le fichier audio de narration (optionnel).
• --voice-api : Utiliser l'API vocale (par défaut : faux).
• --output : Chemin de sortie pour la vidéo finale.

Workflow

1. Analyse de la référence : Extraction des métriques visuelles (plans, transitions, couleur).
2. Génération de la narration : Si --narration est fourni, utiliser le fichier ; sinon, appeler l'API vocale ou le fallback.
3. Synchronisation : Aligner la narration avec les scènes de la vidéo.
4. Sous-titres : Transcrire l'audio avec Whisper et ajouter des sous-titres.
5. Contrôle qualité : Vérifier la résolution (≥1080p), le débit (≥10 Mbps) et le codec (H.265 recommandé).
6. Export : Générer la vidéo finale avec FFmpeg.

Exemple

from skill import VideoSkill
skill = VideoSkill()
video = skill.create(
    reference="demo_reel.mp4",
    narration="voiceover.mp3",
    quality="high"
)

Support

Plateformes : Codex (agent IA de développement).

Pour toute question, ouvrez une issue sur le dépôt GitHub.