liven — Image vers Vidéo (Cloud)
Donne vie aux images fixes en utilisant le modèle de diffusion vidéo rapide LTX-2.3 exécuté sur l'infrastructure cloud de fal.ai. Fournissez une image et une description de mouvement ; le modèle génère un court clip vidéo (6 à 20 secondes selon les paramètres).
Le répertoire du skill (où se trouve ce SKILL.md) est appelé $SKILL_DIR ci-dessous.
Basé sur le cloud. Aucun GPU local requis. Nécessite la variable d'environnement
FAL_API_KEY. Tarification : 0,04 $/s pour 1080p, 0,08 $/s pour 1440p, 0,16 $/s pour 4K.
Quand l'utiliser
Utilisez ce skill lorsque l'utilisateur souhaite :
- Animer une photo ou une illustration en une courte vidéo sans GPU local
- Créer un mouvement cinématique à partir d'une image fixe (par exemple, zoom lent, panoramique, scintillement de lumière)
- Générer du contenu vidéo pour les réseaux sociaux à partir de photos de produits ou de portraits
- Utiliser des résolutions élevées (jusqu'en 4K) sans contraintes de VRAM locale
Configuration (première exécution uniquement)
cd "$SKILL_DIR" && uv sync
Définissez la variable d'environnement FAL_API_KEY :
export FAL_API_KEY="votre-clé-api-ici"
Flux de travail de l'agent
1. Interroger l'utilisateur
Avant d'animer l'image, j'ai besoin de savoir :
💬 Prompt de mouvement (obligatoire)
Décrivez le mouvement souhaité, par exemple :
"push-in cinématique lent, lumière dorée, dérive subtile de la caméra"
🎬 Paramètres de clip
- duration — durée de la vidéo en secondes (par défaut : 6, options : 6, 8, 10, 12, 14, 16, 18, 20)
Remarque : les durées >10s ne prennent en charge que 25 FPS et 1080p
- resolution — qualité de sortie (par défaut : 1080p, options : 1080p, 1440p, 2160p/4K)
- aspect_ratio — rapport hauteur/largeur de la vidéo (par défaut : auto, options : auto, 16:9, 9:16)
- fps — images par seconde (par défaut : 25, options : 24, 25, 48, 50)
- generate_audio — générer un audio IA pour correspondre à la vidéo (par défaut : true)
📁 Répertoires d'entrée / sortie (par défaut : ./input et ./output)
Attendez la réponse de l'utilisateur avant de continuer.
2. Modifier config.json
Écrivez ou mettez à jour $SKILL_DIR/config.json en fonction des choix de l'utilisateur.
3. Exécuter
cd "$SKILL_DIR" && uv run python scripts/img2vid.py --config config.json
4. Rapporter les résultats
Informez l'utilisateur :
- Chemins des fichiers de sortie
- Durée et résolution de la vidéo
- Estimation du coût (basée sur la durée et la résolution)
- URL de téléchargement direct (les vidéos sont hébergées temporairement sur fal.media)
Référence de configuration
| Clé | Valeurs | Défaut | Description |
|---|---|---|---|
input_dir | chemin | ./input | Dossier contenant les images sources |
output_dir | chemin | ./output | Dossier de destination |
prompt | chaîne | (obligatoire) | Description du mouvement |
duration | entier | 6 | Durée de la vidéo en secondes (6-20) |
resolution | chaîne | 1080p | Résolution de sortie : 1080p, 1440p, 2160p |
aspect_ratio | chaîne | auto | Rapport hauteur/largeur : auto, 16:9, 9:16 |
fps | entier | 25 | Images par seconde : 24, 25, 48, 50 |
generate_audio | booléen | true | Générer un audio IA pour la vidéo |
end_image_url | chaîne | null | Image de fin facultative pour les vidéos de transition |
Invocations courantes
# Animer avec un prompt de mouvement (utilise les valeurs par défaut : 6s, 1080p, 25fps)
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "push-in cinématique lent, lumière dorée"
# Générer une vidéo plus longue de 10 secondes
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "vent doux dans les arbres" --duration 10
# Créer une vidéo verticale pour les réseaux sociaux
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "mouvement subtil de la caméra" --aspect-ratio 9:16
# Qualité 4K (coût plus élevé : 0,16 $/s)
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "zoom arrière cinématique" --resolution 2160p --duration 8
# Fréquence d'images plus élevée pour un mouvement plus fluide
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "séquence d'action rapide" --fps 48
# Désactiver la génération audio
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "scène de méditation silencieuse" --no-audio
# Créer une transition entre deux images
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "transition morphing fluide" \
--end-image /chemin/vers/image_finale.jpg
Sortie
Chaque image d'entrée produit un clip .mp4 dans output_dir, nommé <nom_image>.mp4. La vidéo est également téléchargée temporairement sur le CDN fal.media et une URL de téléchargement est fournie dans la sortie de la console.
Les métadonnées vidéo (résolution, fps, durée) sont affichées après la génération.
Gestion des erreurs
- FAL_API_KEY manquante → message d'erreur clair avec instructions de configuration
- Format d'image invalide → erreur avec les formats pris en charge (PNG, JPEG, WebP, AVIF, HEIF)
- Erreurs API → message d'erreur de fal.ai propagé
- Problèmes réseau → logique de nouvelle tentative avec messages d'erreur clairs
Référence tarifaire
| Résolution | Prix par seconde |
|---|---|
| 1080p | 0,04 $ |
| 1440p | 0,08 $ |
| 2160p (4K) | 0,16 $ |
Exemples :
- Vidéo de 6s en 1080p = 0,24 $
- Vidéo de 10s en 1080p = 0,40 $
- Vidéo de 10s en 4K = 1,60 $