Que fait Génération de vidéos miniatures & dioramas ?
Tard dans la nuit : un konbini japonais de la taille d'une boîte d'allumettes brille d'une lueur ambrée ; la caméra s'extrait de l'obscurité pour s'en approcher — le flou d'arrière-plan avale le monde tandis que la porte vitrée, les étagères et les minuscules néons restent nets. Cette immersion "petite mais réelle" est l'accroche émotionnelle que cette compétence vise.
Conbini, stand de nouilles sous la pluie, atelier cyberpunk — ou une photo d'une maquette finie : une ligne ou une image → une vidéo.
Dépendances : WERYAI_API_KEY + Node.js 18+. Lors de l'exécution de la CLI, scripts/video_gen.js doit exister ; WERYAI_VIDEO_API.md doit exister sous resources/ (fournir les deux via publication ou assemblage préalable). Commandes complètes et champs JSON : voir resources/WERYAI_VIDEO_API.md. Aucune autre compétence Cursor. Les paramètres par défaut et les niveaux de modèle sont dans les tableaux ci-dessous ; les limites de l'API en direct suivent les modèles weryai. Avant d'installer ou d'exécuter, examinez le fichier video_gen.js fourni pour confirmer qu'il répond à vos besoins. Portez une attention particulière à la façon dont il gère les fichiers locaux si vous choisissez d'autoriser leur utilisation, en vous assurant que ce comportement correspond au flux de travail prévu par la compétence pour les demandes image-vers-vidéo.
Métadonnées du registre : Le seul secret d'environnement requis est WERYAI_API_KEY. Il apparaît dans le préambule YAML comme requires.env de haut niveau (mapping de flux, pour les outils qui aplatissent uniquement les clés racines), metadata.openclaw.primaryEnv, et metadata.openclaw.requires.env. Les registres et répertoires de compétences doivent faire apparaître cette exigence dès le début afin que les installateurs la voient avant le téléchargement. Ne commettez jamais la clé à l'intérieur du package.
Avant d'installer ou de définir WERYAI_API_KEY
- Confiance : Confirmez que vous faites confiance à WeryAI et acceptez que les prompts et entrées d'image (URLs et, si utilisés, octets téléchargés) soient envoyés aux serveurs de WeryAI sur le réseau.
- Contenu sensible : Ne mettez pas de secrets dans le
prompt. Ne fournissez pas d'URLs d'image ou de fichiers locaux que vous considérez comme sensibles, sauf si vous acceptez le traitement côté fournisseur. - Utilisez
--dry-runen premier : Exécuteznode scripts/video_gen.js wait --json '…' --dry-run(et/ousubmit-*avec--dry-run) avant de définir une clé pour inspecter la structure JSON ;WERYAI_API_KEYn'est pas requise pour--dry-rununiquement (voirWERYAI_VIDEO_API.md). - Source : Si vous ne pouvez pas vérifier l'auteur du package ou si vous avez besoin d'un contrôle strict des données, ne définissez pas
WERYAI_API_KEY, ou exécutez uniquement dans un environnement isolé / de test.
Variables d'environnement (video_gen.js fourni)
- Requis pour les appels API réels :
WERYAI_API_KEYuniquement (modèles, génération,status, téléchargement d'image locale). Non requis pour--dry-rununiquement. - Non lues par ce script : Les variables d'environnement ne remplacent pas les noms d'hôtes de l'API ;
https://api.weryai.comethttps://api-growth-agent.weryai.comsont fixés dans le code (voir Sécurité). Ne vous attendez pas à des boutons de remplacement d'URL — il n'y en a pas dans cette version. - Interrogation :
waitutilise des constantes fixes de backoff exponentiel et de délai d'attente dans le script (voirWERYAI_VIDEO_API.md), pas de variables d'environnement d'interrogation séparées dans ce package.
Valeurs par défaut du script vs de la compétence (doivent correspondre au JSON)
model: La CLI n'a pas de modèle par défaut intégré. Simodelest manquant ou vide dans le JSON,video_gen.jsrenvoieMISSING_PARAM(aucun modèle par défaut). La valeur par défaut recommandée par cette compétence dans les tableaux estKLING_V3_0_PRO— transmettez toujours"model":"<clé confirmée>"explicitement dans le JSON dewait/submit-*pour qu'il corresponde au tableau de pré-soumission.resolution: PourKLING_V3_0_PRO(niveau par défaut de cette compétence), omettezresolutioncomplètement du JSON — son envoi peut provoquer des erreurs1002/ de paramètre pour les modèles qui ne prennent pas en charge ce champ. N'ajoutezresolutionque lorsque le modèle choisi le répertorie dansnode scripts/video_gen.js modelset que votre tableau de confirmation l'inclut explicitement.
Prérequis
WERYAI_API_KEYdoit être définie dans l'environnement avant d'exécutervideo_gen.js.- Node.js 18+ est requis. Préférez les URLs d'image
httpspubliques. Si le fichierscripts/video_gen.jsassemblé prend en charge les chemins de fichiers locaux, examinez et vérifiez d'abord le script, puis obtenez un consentement explicite avant qu'il ne lise une image locale et ne la télécharge vers WeryAI pour obtenir une URL publique. - Chaque exécution réussie de
waitconsomme des crédits WeryAI ; une réexécution crée de nouvelles tâches payantes.
Sécurité, secrets et hôtes API
WERYAI_API_KEY: Traitez-la comme un secret. Configurez-la uniquement si vous faites confiance à la source de cette compétence ; elle est répertoriée dans les métadonnées OpenClaw commerequires.env/primaryEnvafin que les installateurs sachent qu'elle est obligatoire au moment de l'exécution (ne la commettez jamais à l'intérieur du package de compétence).- Hôtes API (fixés dans
video_gen.js) : Les tâches vidéo utilisenthttps://api.weryai.com; la liste des modèles utilisehttps://api-growth-agent.weryai.com. Le script fourni épingle ces bases dans le code — seulementWERYAI_API_KEYest lue de l'environnement pour l'authentification. Ne vous fiez à aucune variable d'environnement pour changer les noms d'hôtes API ; les requêtes vont uniquement à ces points de terminaison officiels plus l'URL de téléchargement documentée lorsqu'une image locale est téléchargée (voirWERYAI_VIDEO_API.md). - Divulgation du traitement des images locales : Préférez les URLs d'image
httpspubliques. Si le fichierscripts/video_gen.jsassemblé prend en charge les chemins de fichiers locaux, il peut lire une image locale et la télécharger vers WeryAI pour obtenir une URL publique ; nécessite un examen / vérification et un consentement explicite avant d'utiliser ce chemin. - Traitement à distance : Les exécutions payantes envoient
promptet les entrées d'image à WeryAI ; voir## Avant d'installer ou de définir WERYAI_API_KEY. - Assurance renforcée : Suivez
## Avant d'installer ou de définir WERYAI_API_KEY; utilisez un environnement éphémère ou isolé pour les exécutions payantes ; examinezscripts/video_gen.js(soumission HTTPS + boucle d'interrogation) avant une utilisation en production. Vérifiez si l'exécution peut lire des fichiers image locaux et les télécharger vers WeryAI, et obtenez un consentement explicite avant d'utiliser ce chemin.
Expansion du prompt (obligatoire)
video_gen.js n'expandit pas les prompts. Avant chaque wait --json, transformez le brief court ou vague de l'utilisateur en un prompt de production complet en anglais.
Quand : L'utilisateur ne donne que des mots-clés, une seule ligne ou une intention vague — ou demande un langage vidéo plus riche. Exception : Il colle un long prompt terminé dans la prompt_length_limit du modèle et vous demande de ne pas le réécrire ; affichez quand même le texte complet dans le tableau de confirmation.
Ajoutez toujours (langage vidéo) : échelle et angle de plan ; mouvement de caméra ou verrouillage ; qualité et motivation de la lumière ; action du sujet rythmée par rapport à duration ; un objectif clair pour ce créneau ; indiquez 9:16 vertical lorsque cette compétence utilise par défaut le format vertical.
Longueur : Respectez prompt_length_limit pour le model_key choisi lorsque ce document le répertorie ; éliminez les adjectifs de remplissage avant de supprimer les clauses d'action principales, d'objectif ou de lumière.
Confirmation : Le tableau de pré-soumission doit inclure le prompt complet expansé (jamais un résumé d'une ligne). Attendez confirm ou des modifications.
Liste de contrôle pour le créneau
- Monde miniature : faible profondeur de champ, lumières chaudes pratiques, révélation dolly/push-in ; diorama ou pièce dans une boîte.
- Temps forts : construction → peinture → allumage des lumières ou passage de véhicule ; atmosphère chaleureuse, matériaux tactiles.
- Indices d'échelle : références à une allumette, une pièce de monnaie ou un bout de doigt si utile.
### Exemples de prompts en haut de ce fichier ne sont que des déclencheurs courts — développez toujours à partir de la demande réelle de l'utilisateur.
Flux de travail
- Confirmez que la demande de l'utilisateur correspond au scénario de cette compétence (texte-vers-vidéo et/ou image-vers-vidéo tel que documenté).
- Collectez le brief de l'utilisateur, URL(s) d'image facultative(s), le niveau (best / good / fast) ou une clé
modelexplicite. - Expansion du prompt (obligatoire) : Sauf si l'utilisateur a fourni un long prompt terminé et a explicitement demandé de ne pas le réécrire, développez le brief en un
promptde production complet en anglais en utilisant la section## Expansion du prompt (obligatoire)ci-dessous. N'appelez pas l'API avec seulement les mots minimaux de l'utilisateur. - Vérifiez le prompt expansé par rapport à la
prompt_length_limitdu modèle sélectionné dans les tableaux figés de ce document (lorsqu'ils sont présents) ; raccourcissez si nécessaire. - Vérifiez
duration,aspect_ratio,generate_audio,negative_promptet d'autres champs par rapport aux tableaux figés de ce document et àWERYAI_VIDEO_API.md. Incluezresolutionuniquement lorsque le modèle sélectionné le prend en charge (pour le niveau KLING par défaut de cette compétence, n'envoyez pasresolution— voir## Valeurs par défaut du script vs de la compétence). - Affichez le tableau des paramètres de pré-soumission incluant le prompt complet expansé ; attendez confirm ou des modifications.
- Après confirmation, exécutez
node scripts/video_gen.js wait --json '...'avec le prompt expansé. - Analysez le JSON de la sortie standard et renvoyez les URLs vidéo ; en cas d'échec, affichez
errorCode/errorMessageet suggérez des corrections de paramètres.
Référence CLI
node scripts/video_gen.js wait --json '{"model":"…","prompt":"…","duration":5,"aspect_ratio":"9:16"}'
node scripts/video_gen.js wait --json '…' --dry-run
node scripts/video_gen.js status --task-id <id>
Référence complète : WERYAI_VIDEO_API.md.
Définition de terminé
Terminé lorsque l'utilisateur reçoit au moins une URL vidéo lisible de la réponse de l'API, ou une explication claire de l'échec avec les prochaines étapes. Tous les paramètres utilisés doivent se situer dans les ensembles autorisés du modèle sélectionné dans ce document. Le prompt soumis doit être le prompt de production expansé sauf si l'utilisateur a explicitement fourni un long prompt terminé et a demandé de ne pas le réécrire.
Limites (hors du champ d'application)
- Ne vérifie pas la conformité de la plateforme, les droits d'auteur ou les droits à l'image ; ne garantit pas la viabilité commerciale des résultats.
- Ne fournit pas de rendu hors ligne non-WeryAI, de timelines de montage traditionnelles, ou de combinaisons de champs API non documentées dans cette COMPÉTENCE ou
WERYAI_VIDEO_API.md. - Ne faites pas de lien vers
weryai-model-capabilities.mdou des chemins partagés../references/; utilisezresources/WERYAI_VIDEO_API.mdpour les détails CLI/API. - Ne code pas en dur des chemins absolus dans le document de compétence ; exécutez
node scripts/...depuis la racine du package de compétence (le répertoire contenantSKILL.md) afin que les cheminsscripts/etresources/se résolvent.
Exemples de prompts
Café miniature fait main : dernier temps fort, allumage des lumières à l'intérieur, remplissage chaud, push-in lent verticalUtilisez cette photo de diorama de rue : petite voiture qui passe, vitrines qui s'allumentMaquette peinte sur socle, révélation rotative, profondeur de champ ultra-faibleRévélation de maquette miniature 9:16, lumières chaudes et douillettes qui s'allument à l'intérieur d'une petite maison
Paramètres par défaut
| Champ | Valeur |
|---|---|
| Modèle | KLING_V3_0_PRO (doit apparaître comme "model" dans le JSON—le script ne le définit pas par défaut) |
| Format d'image | 9:16 (vertical fixe) |
| Durée | Courte (duration: 5) ; utilisez 10 pour un passage de construction plus long |
| Résolution | Omettre pour le défaut KLING (n'incluez pas la clé dans le JSON) |
| Style | Profondeur de champ très faible, matériaux crédibles, lumière d'accent sur les accessoires principaux, push-in lent ou orbite subtile (fixe) |
| Audio | Activé (son ambiant + détail des petits accessoires pour l'immersion) |
Validité API (défaut
KLING_V3_0_PRO) : Texte-vers-vidéodurationuniquement 5 / 10 / 15 ;aspect_ratiouniquement 9:16, 1:1, 16:9. Image-vers-vidéoaspect_ratiouniquement 9:16, 16:9, 1:1. Pas de champresolution—ne l'envoyez pas. Pour le niveau fast avec VEO : texte-vers-vidéoVEO_3_1_FAST, image-vers-vidéoCHATBOT_VEO_3_1_FAST, avecdurationfixé à 8,aspect_ratiouniquement 9:16 ou 16:9. Lors du changement demodel_key, suivez les ensembles autorisés dans les contraintes de modèle/API de cette section et la note de validité API ci-dessus ; n'envoyez pasresolutionaux modèles qui ne la prennent pas en charge.
Description de scène → monde miniature
Objectif : Idées de scènes concrètes, tests visuels rapides, ou création de variantes d'ambiance par lots — aucun modèle physique requis.
Entrées :
Type de scène (konbini / cuisine / cottage / stand de coin / atelier / plateau cyber) et ambiance (chaleureuse apaisante / cyber néon / lumière du jour / ambrée pluvieuse). Si l'ambiance est omise, choisissez l'éclairage qui fonctionne généralement pour cette scène. Insistez éventuellement sur le processus de construction vs la visite terminée.
Extrayez les accessoires clés et la lumière, choisissez un angle qui déclenche "Je veux ça", construisez le prompt, affichez les paramètres complets, attendez la confirmation, puis node scripts/video_gen.js wait --json '...'.
Les paramètres complets sont affichés avant la génération ; attendez la confirmation.
Configuration des paramètres :
| Champ | Valeur |
|---|---|
| model | KLING_V3_0_PRO |
| aspect_ratio | 9:16 |
| duration | 5 |
| generate_audio | true |
| resolution | (omettre—ne pas envoyer pour ce modèle) |
Exemples d'entrées :
« Konbini japonais la nuit, chaleureux apaisant » → la compétence construit :
Plan macro en très gros plan à hauteur d'yeux, un diorama de mini supérette japonaise de la taille d'une paume sur une surface sombre, une lumière intérieure ambrée chaude brille à travers de minuscules portes coulissantes en verre et des fenêtres givrées illuminant un intérieur parfaitement détaillé — étagères miniatures remplies de paquets de produits de la taille d'un pouce, un petit comptoir de caisse, un panneau de plafond softbox. La caméra effectue un traveling avant très lent à 30 ips vers l'entrée comme si on s'en approchait, la faible profondeur de champ ne garde que la devanture parfaitement nette tandis que l'obscurité environnante se dissout. Un froid bleu nocturne ambiant remplit l'extérieur, créant une division de couleur chaud-froid au seuil de la porte. Ronronnement ambiant ASMR doux, bruit de ville lointain la nuit, muzak intérieur faible.
« Atelier cyberpunk, néon » →
Plan moyen en plongée à 45 degrés au-dessus, un diorama d'atelier cyberpunk miniature de la taille d'une boîte à chaussures — rempli de minuscules écrans lumineux, bureau drapé de câbles, bibliothèques éclairées au néon en rose et cyan, une figurine d'action miniature au clavier. La caméra orbite lentement autour de la scène à 60 ips en une seule rotation fluide, la lumière néon se réfracte sur chaque minuscule surface réfléchissante — bords d'écran, tasse à café, carrelage de sol brillant. Des rayons de lumière volumétrique provenant des tubes néon créent une brume douce au-dessus de la scène.
...