Compétence Vidéo Courte
Les vidéos courtes (≤ 10 s) sont le point idéal des modèles texte-vers-vidéo actuels — ils excellent pour un plan avec une idée, mais sont plus faibles pour les récits multi-coupes. Planifiez un plan par appel.
Cas particulier : hyperframes-html n'est pas un modèle photoréaliste texte-vers-vidéo. C'est un moteur de rendu local HTML-vers-MP4. Pour ce modèle, n'imitez pas la cinématographie ou la physique de caméra « réelle ». Traitez le brief comme une carte de motion design / titre / interstice produit, posez au plus une question de clarification, puis exécutez immédiatement.
Carte des ressources
video-shortform/
├── SKILL.md
└── example.html
Flux de travail
Étape 0 — Lire les métadonnées du projet
videoModel, videoLength (secondes), videoAspect. Ce sont des verrous stricts — adaptez l'invite à ce que le modèle choisi supporte (Seedance 2 plafonne à 10 s ; Kling 4 supporte jusqu'à 10 s + image-vers-vidéo ; Veo 3 supporte 8 s avec audio).
Étape 1 — Planifier le plan
Écrivez la liste des plans AVANT d'appeler le modèle :
| Emplacement | Contenu |
|---|---|
| Sujet | Qu'y a-t-il dans le cadre ? |
| Caméra | Statique / panoramique / push-in / orbite ? |
| Éclairage | Direction clé + température |
| Mouvement | Qu'est-ce qui bouge, à quel rythme ? Mouvement du sujet vs mouvement de la caméra. |
| Son | Ambiance sonore ? (uniquement si le modèle supporte l'audio) |
Normalement, montrez cela à l'utilisateur sous forme d'un plan d'une phrase avant d'exécuter — il peut rediriger à moindre coût.
Pour hyperframes-html, sautez la narration supplémentaire avant exécution une fois que l'utilisateur a répondu au formulaire de découverte. Transformez le plan en invite de génération réelle et exécutez immédiatement.
Étape 2 — Composer l'invite
Utilisez le format préféré du modèle en amont (Seedance : mouvement + caméra + ambiance ; Kling : sujet + caméra + style ; Veo : sujet + cinématographie + son). Liez directement videoAspect et videoLength du projet aux paramètres de l'API ; ne les mettez jamais dans le texte en prose.
Pour hyperframes-html, rédigez un brief de motion design concis au lieu d'une invite de réalisme de caméra. Concentrez-vous sur le sujet, la disposition, la palette, le caractère du mouvement et le ton général. Ne passez pas de tours à raconter les vérifications d'environnement, les fichiers latéraux manquants ou les mises à jour de statut « Je suis sur le point d'exécuter ».
Étape 3 — Exécuter via le contrat média
Utilisez le répartiteur unifié — n'appelez pas les API du fournisseur à la main :
"$OD_NODE_BIN" "$OD_BIN" media generate \
--project "$OD_PROJECT_ID" \
--surface video \
--model "<videoModel from metadata>" \
--aspect "<videoAspect from metadata>" \
--length <videoLength seconds> \
--output "<short-slug>-<seconds>s.mp4" \
--prompt "<assembled shot prompt from Step 2>"
La commande imprime une ligne de JSON : {"file": {"name": "...", ...}}. Les données arrivent dans le projet ; le FileViewer les lit automatiquement.
Étape 4 — Passer la main
Répondez avec : le résumé du plan, le nom de fichier renvoyé par le répartiteur, et une phrase sur quoi essayer si l'utilisateur veut une variation.
Pour hyperframes-html, gardez la réponse particulièrement courte : ce qui a été rendu, le nom de fichier, et une idée de variation concrète.
Règles strictes
- Un plan par tour. Les timelines multi-plans relèvent d'une compétence hyperframes / vidéo interactive, pas ici.
- Respectez exactement
videoAspect— les nouveaux rendus sont lents. - Ne livrez jamais une vidéo sans sauvegarder le fichier — l'utilisateur s'attend à voir quelque chose dans le visualiseur de fichiers.
- Lorsque le modèle sous-jacent échoue (filtre NSFW, politique de contenu, timeout), signalez l'erreur textuellement. Ne réessayez pas en silence.
- Ne prétendez pas qu'un rendu a été « envoyé », « démarré » ou « est en cours » à moins que vous n'ayez déjà appelé
"$OD_NODE_BIN" "$OD_BIN" media generate.