Video Prompt Builder
Répartiteur générique et indépendant du fournisseur pour les invites de génération vidéo. Lit la matrice de routage dans .specs/architecture/PROVIDERS.md, décide quel fournisseur doit exécuter la pièce, et délègue au spécialiste approprié (higgsfield-prompt-builder, topview-prompt-builder, wavespeed-batch, hyperframes-prompt-builder).
Quand invoquer
- Toute étape de génération vidéo dans le pipeline (
brief -> script -> creativelorsque le type créatif est vidéo). - Lorsqu’une pièce déclare
type: videodans.specs/pieces/*.md. - Tests A/B de hooks vidéo entre fournisseurs et lorsque l’orchestrateur a besoin d’un point d’entrée unique.
- Relancer le même brief sur un fournisseur différent après qu’un gagnant A/B a été choisi.
- Lorsqu’un agent en amont a un brief mais ne sait pas quel fournisseur choisir.
Entrées
brief: objet. Brief visuel avec au moinssubject,motion,mood,aspect,duration_seconds.task_kind: chaîne. L’un des suivants :cinematic_reel,motion_control,ugc_product_holder,product_demo,talking_head,batch_hook_test,motion_typography,data_viz_reel,programmatic_short.piece_path: chaîne, optionnelle. Chemin vers le fichier de la pièce. Peut contenirprovider_override.video.dry_run: booléen, optionnel. Lorsqu’il est vrai, retourne le fournisseur résolu et les paramètres sans appeler le MCP.
Processus
- Lire
.specs/architecture/PROVIDERS.mdet analyser la matrice Vidéo en une correspondancetask_kind -> provider. - Si
piece_pathest défini et contientprovider_override.video, utiliser la surcharge. - Sinon, rechercher
task_kinddans la matrice. Si inconnu, utiliser la valeur par défaut de la matrice pourcinematic_reel. - Vérifier que le fournisseur choisi a les variables d’environnement définies (
HIGGSFIELD_MCP_ACTIVE,TOPVIEW_API_KEY,WAVESPEED_API_KEY,HYPERFRAMES_ACTIVE). - Mapper le fournisseur au skill spécialiste : Higgsfield ->
higgsfield-prompt-builder, Topview ->topview-prompt-builder, Wavespeed ->wavespeed-batch, Hyperframes ->hyperframes-prompt-builder. - Traduire les champs du brief dans la forme d’entrée attendue par le spécialiste.
- Invoquer le spécialiste et capturer ses
paramset sa sortiemcp_tool. - Si
dry_run, retourner le fournisseur résolu, les paramètres et l’outil MCP. Sinon, appeler le MCP et retourner la référence de l’artefact. - Journaliser l’exécution dans
data/video-usage.jsonlavec l’horodatage, le fournisseur, letask_kindet le résultat.
Sorties
provider_used: chaîne.params: objet. Objet de paramètres final prêt pour l’appel MCP.mcp_tool: chaîne. Le nom de l’outil MCP.artifact_ref: chaîne, sauf en mode dry_run. Chemin ou URL de la vidéo générée.cost_estimate_usd: nombre.
Exemples
Exemple 1 : reel cinématographique routé vers Higgsfield
Entrée : { brief: { subject: "model in linen suit", motion: "tracking shot", mood: "editorial", aspect: "9:16", duration_seconds: 6 }, task_kind: "cinematic_reel" }
Sortie : { provider_used: "higgsfield", mcp_tool: "higgsfield_seedance_generate", params: {...} }
Exemple 2 : publicité UGC routée vers Topview
Entrée : { brief: { subject: "skincare bottle held by avatar", motion: "static", mood: "friendly", aspect: "9:16", duration_seconds: 15 }, task_kind: "ugc_product_holder" }
Sortie : { provider_used: "topview", mcp_tool: "topview_avatar_generate", params: {...} }
Exemple 3 : reel KPI hebdomadaire routé vers Hyperframes
Entrée : { brief: { headline: "Semana 21 em números", aspect: "9:16", duration_seconds: 12, variables: { leads: 42, delta_pct: 12 } }, task_kind: "programmatic_short" }
Sortie : { provider_used: "hyperframes", mcp_tool: "hyperframes_render", params: { composition_spec: {...}, render_args: {...} } } — rendu local via les skills hyperframes + hyperframes-cli.
Modes de défaillance
task_kindnon présent dans la matrice : journaliser un avertissement et utiliser la valeur par défautcinematic_reel.- Variable d’environnement requise manquante pour le fournisseur choisi : passer au fournisseur suivant dans la matrice et afficher un avertissement.
- Le skill spécialiste retourne une erreur : l’afficher et ne pas réessayer automatiquement sur un autre fournisseur sauf si l’appelant le demande.
- La durée dépasse la limite du fournisseur : réduire à la durée maximum du fournisseur et afficher un avis.
Skills associés
higgsfield-prompt-builder: spécialiste pour Soul, DoP, Seedance.topview-prompt-builder: spécialiste pour les publicités UGC et pilotées par avatar.wavespeed-batch: spécialiste pour les tests de hook batch bon marché.hyperframes-prompt-builder: spécialiste pour la typographie animée en HTML, les reels de visualisation de données et les courts métrages paramétrés programmatiques.llm-router: répartiteur séparé pour la génération de texte ; même modèle, domaine différent.qa-tech-specs: valide la vidéo finale par rapport aux spécifications de la plateforme.