Compétence de vidéos courtes (Short-form)
Les vidéos courtes (≤ 10s) sont le point idéal pour les modèles texte-vers-vidéo actuels — ils excellent pour un plan avec une idée, mais sont plus faibles pour les récits à plusieurs plans. Planifiez un plan par appel.
Cas particulier : hyperframes-html n'est pas un modèle photoréaliste texte-vers-vidéo. C'est un rendu local HTML vers MP4. Pour ce modèle, ne simulez pas de cinématographie ou de physique de caméra « réaliste ». Traitez le brief comme une carte de design motion / titre / interstice produit, posez au plus une question de clarification, puis déclenchez immédiatement.
Plan 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 — limitez l'invite à ce que le modèle choisi supporte (Seedance 2 plafonne à 10s ; Kling 4 supporte jusqu'à 10s + image-vers-vidéo ; Veo 3 supporte 8s avec audio).
Étape 1 — Planifier le plan
Écrivez la liste des plans avant d'appeler le modèle :
| Emplacement | Contenu |
|---|---|
| Sujet | Qu'est-ce qui est dans le cadre ? |
| Caméra | Statique / panoramique / poussée / orbite ? |
| Éclairage | Direction clé + température |
| Mouvement | Qu'est-ce qui bouge, à quel rythme ? Mouvement du sujet vs mouvement de la caméra. |
| Son | Fond sonore ambiant ? (seulement si le modèle supporte l'audio) |
Normalement, montrez cela à l'utilisateur comme un plan d'une phrase avant de déclencher — ils peuvent rediriger à moindre coût.
Pour hyperframes-html, sautez la narration pré-dispatching supplémentaire une fois que l'utilisateur a répondu au formulaire de découverte. Réduisez le plan dans l'invite de génération réelle et déclenchez immédiatement.
Étape 2 — Composer l'invite
Utilisez le format préféré du modèle amont (Seedance : mouvement + caméra + ambiance ; Kling : sujet + caméra + style ; Veo : sujet + cinématographie + son). Liez directement les métadonnées videoAspect et videoLength du projet aux paramètres de l'API ; ne les mettez jamais dans le texte de l'invite.
Pour hyperframes-html, rédigez un bref de design motion 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 à narrer des vérifications d'environnement, des fichiers adjacents manquants ou des mises à jour de statut « Je vais déclencher ».
Étape 3 — Déclencher via le contrat média
Utilisez le répartiteur unifié — n'appelez pas les API des fournisseurs manuellement :
node "$OD_BIN" media generate \
--project "$OD_PROJECT_ID" \
--surface video \
--model "<videoModel from metadata>" \
--aspect "<videoAspect from metadata>" \
--length <videoLength seconds> \
--output "<slug-court>-<secondes>s.mp4" \
--prompt "<invite de plan assemblée de l'étape 2>"
La commande imprime une ligne de JSON : {"file": {"name": "...", ...}}. Les octets arrivent dans le projet ; le Visualiseur de fichiers le lit automatiquement.
Étape 4 — Remise
Répondez avec : le résumé du plan, le nom de fichier retourné par le répartiteur, et une phrase sur ce qu'il faut essayer si l'utilisateur souhaite 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 concrète de variation.
Règles strictes
- Un plan par tour. Les timelines multi-plans relèvent d'une compétence hyperframes / vidéo interactive, pas d'ici.
- Respectez
videoAspectexactement — les rendus sont lents. - Ne livrez jamais une vidéo sans sauvegarder le fichier — l'utilisateur s'attend à quelque chose à lire 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 d'exécution » sauf si vous avez déjà appelé
od media generate.