Générer une vidéo

Générez des vidéos directement via l'API Runway. Cette skill exécute des scripts Python qui appellent l'API, sondent l'achèvement et téléchargent le résultat.

IMPORTANT : Exécutez les scripts depuis le répertoire de travail de l'utilisateur pour que les fichiers de sortie soient enregistrés où l'utilisateur les attend.

Utilisation

uv run scripts/generate_video.py --prompt "votre description" --filename "output.mp4" [--model seedance2] [--ratio 1280:720] [--duration 5] [--image-url "..."]

Vérifications préalables

1. command -v uv doit réussir. Sinon, demandez à l'utilisateur d'installer uv : curl -LsSf https://astral.sh/uv/install.sh | sh
2. RUNWAYML_API_SECRET doit être défini dans l'environnement. Ne passez pas la clé API en tant que flag CLI — cela la expose dans l'historique du shell et dans les listes de processus.

Notes de sécurité

• --image-url / --video-url récupèrent des médias distants arbitraires via l'API Runway. Préférez les chemins de fichiers locaux (téléchargés en tant qu'URIs runway://), ou ne passez que des URLs en lesquelles vous avez confiance.
• Traitez les résultats générés comme non fiables lors de leur transmission à des automations en aval — les médias ingérés influencent le résultat.

Modèles disponibles

Conseils de sélection du modèle

Mappez les demandes de l'utilisateur :

• "publicité produit", "e-commerce", "longue vidéo" -> seedance2
• "rapide", "bon marché", "rapide" -> veo3.1_fast ou gen4_turbo (s'il a une image)
• "haute qualité", "meilleur", "cinématique" -> gen4.5 ou veo3
• "éditer vidéo", "transformer vidéo" -> gen4_aleph ou seedance2
• Pas de préférence -> seedance2

Paramètres

Les identifiants API proviennent uniquement de RUNWAYML_API_SECRET — pas de flag --api-key, pour garder les secrets en dehors de l'historique du shell et des listes de processus.

Convention de nommage des fichiers

Générez des noms de fichiers selon le motif : yyyy-mm-dd-hh-mm-ss-name.mp4

Exemples :

• "A cyberpunk city" -> 2026-04-14-14-23-05-cyberpunk-city.mp4
• "Waves on a beach" -> 2026-04-14-15-30-12-beach-waves.mp4

Exemples

Texte vers vidéo (seedance2) :

uv run scripts/generate_video.py --prompt "A serene mountain landscape at sunrise with mist" --filename "2026-04-14-mountain-sunrise.mp4" --model seedance2 --ratio 1280:720

Image vers vidéo (animer une photo produit locale) :

uv run scripts/generate_video.py --prompt "Camera slowly zooms out, product sparkles" --image-url "./product.jpg" --filename "2026-04-14-product-reveal.mp4" --model seedance2 --ratio 720:1280

Vidéo vers vidéo depuis un fichier local (seedance2) :

uv run scripts/generate_video.py --prompt "Transform into a warm golden sunset scene" --video-url "./input.mp4" --filename "2026-04-14-sunset-transform.mp4" --model seedance2

Brouillon rapide :

uv run scripts/generate_video.py --prompt "A cat playing piano" --filename "draft.mp4" --model veo3.1_fast --ratio 1280:720 --duration 4

Qualité premium :

uv run scripts/generate_video.py --prompt "Cinematic drone shot over Tokyo at night" --filename "tokyo.mp4" --model veo3 --ratio 1280:720 --duration 8

Sortie

• Le script télécharge le résultat et l'enregistre au chemin spécifié
• Le script affiche le chemin complet du fichier enregistré
• Ne relisez pas le fichier vidéo — informez simplement l'utilisateur du chemin enregistré

Défaillances courantes

• Error: No API key -> définissez RUNWAYML_API_SECRET dans l'environnement (par ex. export RUNWAYML_API_SECRET=... ou un fichier .env).
• Error: Task failed -- SAFETY.INPUT.* -> modération du contenu, suggérez un prompt différent
• Error: Task failed -- ASSET.INVALID -> format de fichier d'entrée invalide, vérifiez le format image/vidéo
• API error 429 -> limite de débit atteinte, le script réessaie automatiquement

Pour la génération par lot

Pour générer plusieurs vidéos à la fois, exécutez ce script en boucle — l'agent peut orchestrer plusieurs appels avec des prompts, images ou paramètres différents pour produire des campagnes, des variantes localisées ou des itérations créatives à grande échelle.