🎬 VideoAgent Video Studio
Utiliser quand : L'utilisateur demande de générer une vidéo, créer une vidéo à partir d'un texte, animer une image, faire un court clip, ou produire une vidéo AI.
Générez de courtes vidéos AI avec 7 moteurs backend. Cette compétence choisit le bon mode (texte-vers-vidéo ou image-vers-vidéo), améliore la requête pour de meilleurs résultats et renvoie l'URL de la vidéo.
Référence rapide
| Intention de l'utilisateur | Mode | Durée typique |
|---|---|---|
| "Fais une vidéo de..." (sans image) | text-to-video | 4–10 s |
| "Anime cette image" / "Fais bouger ceci" | image-to-video | 4–6 s |
| "Transforme ceci en vidéo avec..." | image-to-video | 4–6 s |
| Cinématique, histoire, publicité | Préférer text-to-video avec requête détaillée | 5–10 s |
Modes de génération
| Mode | Description | Modèles |
|---|---|---|
| text-to-video | Requête texte uniquement → vidéo | minimax, kling, veo, hunyuan, grok, seedance |
| image-to-video | Image unique + requête → clip animé | minimax, kling, veo, pixverse, grok, seedance |
| basé sur référence | Images/vidéo de référence → sortie cohérente | minimax, kling, veo, hunyuan, grok, seedance |
Modèles (utiliser --model <id>)
| ID du modèle | T2V | I2V | Référence | Notes |
|---|---|---|---|---|
minimax | ✅ | ✅ | ✅ | Image de référence de sujet, cohérence du personnage |
kling | ✅ | ✅ | ✅ | Multi-éléments / personnage / image clé (O3) |
veo | ✅ | ✅ | ✅ | Google Veo 3.1, plusieurs images de référence |
hunyuan | ✅ | — | ✅ | Transfert de style vidéo-vers-vidéo |
pixverse | — | ✅ | — | Image-vers-vidéo stylisée |
grok | ✅ | ✅ | ✅ | Édition vidéo via vidéo de référence |
seedance | ✅ | ✅ | ✅ | Seedance 1.5 Pro, audio synchronisé, 4–12 s |
Détails complets des modèles et référence des points de terminaison : references/models.md.
Comment générer une vidéo
Étape 1 — Choisir le mode et améliorer la requête
- Texte-vers-vidéo : Développez avec le sujet, l'action, le mouvement de la caméra, l'éclairage et le style. Soyez précis sur le mouvement (ex. "la caméra zoome lentement", "le personnage marche de gauche à droite").
- Image-vers-vidéo : Décrivez le mouvement à appliquer à l'image (ex. "brise légère dans les cheveux", "la caméra panoramique sur la scène"). Voir references/prompt_guide.md pour des modèles.
Étape 2 — Exécuter le script
Texte-vers-vidéo :
node {baseDir}/tools/generate.js \
--mode text-to-video \
--prompt "<requête améliorée>" \
--duration <secondes> \
--aspect-ratio <rapport>
Image-vers-vidéo :
node {baseDir}/tools/generate.js \
--mode image-to-video \
--prompt "<description du mouvement>" \
--image-url "<URL publique de l'image>" \
--duration <secondes> \
--aspect-ratio <rapport>
Paramètres :
| Paramètre | Défaut | Description |
|---|---|---|
--mode | text-to-video | text-to-video ou image-to-video |
--prompt | (requis) | Description de la scène ou du mouvement |
--image-url | — | Requis pour image-to-video ; URL publique de l'image |
--duration | 5 | Durée en secondes (généralement 4–10) |
--aspect-ratio | 16:9 | 16:9, 9:16, 1:1, 4:3, 3:4 |
--model | auto | ID du modèle (ex. kling, veo, grok, seedance) ; auto = proxy choisit |
Autres commandes :
| Commande | Description |
|---|---|
node tools/generate.js --list-models | Liste les modèles disponibles via le proxy |
node tools/generate.js --status --job-id <id> | Vérifier le statut d'une tâche asynchrone |
Étape 3 — Retourner le résultat
Le script retourne du JSON :
{
"success": true,
"mode": "text-to-video",
"videoUrl": "https://...",
"duration": 5,
"aspectRatio": "16:9"
}
Envoyez videoUrl à l'utilisateur.
Exemples de conversations
Utilisateur : "Génère une courte vidéo d'un chat marchant sous la pluie, cinématique."
node {baseDir}/tools/generate.js \
--mode text-to-video \
--prompt "Un chat marchant sous la pluie, rues mouillées, reflets néon, éclairage cinématographique, ralenti, 4K" \
--duration 5 \
--aspect-ratio 16:9
Utilisateur : "Anime cette photo" (l'utilisateur télécharge un paysage)
node {baseDir}/tools/generate.js \
--mode image-to-video \
--prompt "Nuages se déplaçant doucement dans le ciel, mouvement subtil de l'herbe, atmosphère cinématographique" \
--image-url "https://..." \
--duration 5 \
--aspect-ratio 16:9
Utilisateur : "Fais une vidéo verticale de 10 secondes d'un versement de café, au ralenti."
node {baseDir}/tools/generate.js \
--mode text-to-video \
--prompt "Gros plan d'un café versé dans une tasse blanche, ralenti, vapeur s'élevant, éclairage doux, photo de produit" \
--duration 10 \
--aspect-ratio 9:16
Utilisateur : "Utilise Google Veo pour un plan cinématographique."
node {baseDir}/tools/generate.js \
--mode text-to-video \
--model veo \
--prompt "Un dragon volant dans des cieux nuageux, éclairage cinématographique, 8s" \
--duration 8 \
--aspect-ratio 16:9
Utilisateur : "Anime ce portrait."
node {baseDir}/tools/generate.js \
--mode image-to-video \
--model grok \
--prompt "Sourire doux, léger mouvement de tête" \
--image-url "https://..." \
--duration 5
Configuration
Aucune clé API par défaut. Les requêtes passent par un proxy hébergé. Définissez ces éléments pour un proxy ou un jeton personnalisé :
| Variable | Requis | Description |
|---|---|---|
VIDEO_STUDIO_PROXY_URL | Non | URL de base du proxy |
VIDEO_STUDIO_TOKEN | Non | Jeton d'authentification si le proxy l'exige |
Base de connaissances
- references/prompt_guide.md — Modèles de requêtes pour texte-vers-vidéo et image-vers-vidéo.
- references/models.md — Liste des modèles, capacités et guide de sélection.
- references/calling_guide.md — Détails des points de terminaison par modèle, paramètres d'entrée et gestion spéciale.