Compétence de production vidéo Plan
Périmètre d'application
Prérequis : La collaboration Plan est déjà activée (scenario(activate, plan) est actif) et la tâche nécessite une production visuelle/vidéo (génération d'image, court-métrage, voix-off, sous-titres).
Choix du fournisseur : Pour la génération d'image, utilisez byted-ark-seedream-skill ; pour la génération vidéo, lisez le script media-production (Volcengine Seedance). Pour les autres fournisseurs, voir agnes-media-generation / wan-media-generation / kling-media-generation.
Informations d'identification (variables d'environnement)
Dans Paramètres → Variables d'environnement, ajoutez les KEY=VALUE requises par la compétence (ex. VOLCENGINE_API_KEY / ARK_API_KEY). Vous pouvez également renseigner les clés d'autres fournisseurs dans Paramètres → Modèle → Médias créatifs.
| Capacité | Clé courante | Compétence |
|---|---|---|
| Génération d'image | VOLCENGINE_API_KEY / ARK_API_KEY | byted-ark-seedream-skill |
| Génération vidéo | idem | media-production |
| Agnes | AGNES_API_KEY | agnes-media-generation |
Changement principal : Tous les métiers médias (scénariste, planificateur visuel, artiste, réalisateur, post-production) sont tous spécifiés dans les steps de plan(goal, steps[]) via assigned_agent. Une fois le plan enregistré et confirmé par l'utilisateur, l'exécution séquentielle commence. Aucun sous-agent n'est délégué en dehors du plan.
Flux de travail
L'utilisateur exprime son besoin
↓
Interroger et confirmer les besoins (sujet, durée, style, format d'écran, etc.)
↓
Planifier directement avec plan(goal, steps[])
step 1: media-screenwriter — scénario/storyboard/voix-off
step 2: media-visual-planner — prompts de génération d'image
step 3: media-artist — génération des keyframes
step 4: media-video-director — production vidéo + voix-off native
step 5: media-post — sous-titres incrustés
↓
Confirmation utilisateur → Exécution (séquentielle, validation par étape)
Étapes d'opération
Première étape : Interroger l'utilisateur sur ses besoins
Collectez activement les informations suivantes auprès de l'utilisateur :
| Question | Exemple |
|---|---|
| Quel est le thème/produit/contenu de la vidéo ? | Publicité pour une nouvelle montre connectée |
| Durée cible ? | 15 secondes / 30 secondes |
| Style visuel ? | Technologique / Chaleureux / Style chinois |
| Format d'écran ? | 16:9 / 9:16 portrait |
| Direction du script voix-off ? | Points forts + slogan de la marque |
| Avez-vous des éléments de référence ? | Image de référence / vidéo concurrente |
Deuxième étape : Planifier directement après confirmation
Une fois les besoins confirmés par l'utilisateur, utilisez directement l'outil plan pour écrire toutes les étapes dans un plan structuré :
plan(
goal="Réaliser une courte vidéo promotionnelle de 15 secondes, thème : xxx, style : xxx",
steps=[
{
"step_id": 1,
"description": "Le scénariste rédige un production brief contenant logline, storyboard et script voix-off",
"assigned_agent": "media-screenwriter",
"expected_output": "outputs/production-brief.md",
"acceptance_criteria": "Contient User intent, logline, visual style, shot list, narration script"
},
{
"step_id": 2,
"description": "Le planificateur visuel transforme le storyboard en prompts de génération d'image",
"assigned_agent": "media-visual-planner",
"expected_output": "outputs/shot-prompts.json",
"depends_on": [1]
},
{
"step_id": 3,
"description": "L'artiste génère les images keyframes du premier plan",
"assigned_agent": "media-artist",
"expected_output": "Images PNG keyframes dans outputs",
"depends_on": [2]
},
{
"step_id": 4,
"description": "Le réalisateur vidéo génère un MP4 avec voix-off native",
"assigned_agent": "media-video-director",
"expected_output": "outputs/*.mp4",
"depends_on": [3]
},
{
"step_id": 5,
"description": "La post-production ajoute les sous-titres incrustés et livre le MP4 final",
"assigned_agent": "media-post",
"expected_output": "outputs/*-subtitled.mp4",
"depends_on": [4]
}
],
flowchart_mermaid="..."
)
Troisième étape : Confirmation utilisateur et exécution
Une fois le plan enregistré, l'utilisateur confirme "Démarrer l'exécution". La phase d'exécution commence alors : les étapes s'exécutent séquentiellement selon l'ordre de dépendance. À chaque étape, l'agent principal valide le livrable avant de passer à l'étape suivante.
Liste des sous-agents médias
| assigned_agent | Rôle | Outils principaux |
|---|---|---|
media-screenwriter | Écrire le scénario, storyboard, script voix-off | read_file, write_to_file |
media-visual-planner | Écrire les prompts de génération d'image | read_file, write_to_file |
media-artist | Générer des images avec Seedream (jimeng) | read_file, terminal → scripts/image_generate.py |
media-video-director | Générer une vidéo à partir d'image avec Seedance + voix-off native | read_file, terminal → scripts/video_generate.py, task_wait.py |
media-post | Sous-titres SRT + incrustation ffmpeg | read_file, terminal → scripts/subtitle_build.py, subtitle_burn.py |
Note : N'incluez pas media-voice-director dans les étapes — Seedance intègre déjà l'audio nativement (generate_audio=true par défaut).
Stack technique
Répertoire des scripts : skills/public/media-production/scripts/ (vous devez d'abord lire la compétence media-production)
| Capacité | Script | Fournisseur |
|---|---|---|
| Génération d'image | image_generate.py | jimeng (Volcengine Ark Seedream) |
| Génération vidéo | video_generate.py + task_wait.py | jimeng (Volcengine Ark Seedance, audio par défaut) |
| Sous-titres | subtitle_build.py + subtitle_burn.py | ffmpeg local |
Gestion des échecs : En cas d'échec de jimeng, il est interdit de basculer automatiquement vers wan/kling. Invitez l'utilisateur à activer un point d'accès au modèle Ark. En cas d'échec avec les mêmes paramètres, ne retentez qu'une seule fois maximum.
Erreurs courantes
- Exécuter directement
image_generate.pydans la session principale en mode plan → il doit être exécuté parmedia-artistdans l'étape du plan - Déléguer un sous-agent en dehors des étapes du plan → tous les métiers doivent être écrits dans le
assigned_agentdes steps du plan - Sauter
task_wait.py→ la génération vidéo n'est pas terminée au moment de la livraison - Déléguer encore
media-voice-directordans le pipeline par défaut → Seedance intègre déjà l'audio nativement, c'est superflu