video-generator — Vidéo Cloud Multi-Modèle (Higgsfield)
Génère des clips vidéo via Higgsfield — une plateforme qui agrège plus de 6 modèles leaders sous une seule API et un seul compte de facturation. Choisissez le modèle adapté à votre compromis coût/qualité ; le reste de l'interface est identique.
Le répertoire de la compétence (où se trouve ce SKILL.md) est appelé $SKILL_DIR ci-dessous.
Basé sur le cloud. Aucun GPU local requis. Nécessite un compte Higgsfield et une clé API depuis cloud.higgsfield.ai.
Modes
| Mode | Déclencheur | Résultat |
|---|---|---|
text-to-video | Aucune image dans input/ | Génère une vidéo à partir de l'invite seule |
image-to-video | Images présentes dans input/ | Anime chaque image en un clip |
auto (par défaut) | — | Choisit le mode ci-dessus automatiquement |
Préréglages
La compétence utilise des préréglages en tant que fines surcouches sur le même moteur vidéo. Un préréglage peut définir le modèle par défaut, le ratio d'aspect, la durée et le préfixe d'invite. Les valeurs de configuration explicites prévalent toujours.
| Préréglage | Idéal pour | Modèle par défaut | Ratio par défaut |
|---|---|---|---|
cinematic (par défaut) | Vidéo cinématique polyvalente | kling | 16:9 |
social-hook | Format court accrocheur | seedance | 9:16 |
motion-design-ad | Publicités animées SaaS/produit | kling | 16:9 |
ecommerce-ad | Clips promotionnels de produits | kling | 9:16 |
brand-story | Récit de marque/fondateur | kling | 16:9 |
product-360 | Présentation isolée d'un produit | kling | 1:1 |
Règles de workflow :
- choisissez un préréglage avant de modifier
config.json - vérifiez que le préréglage correspond au style de sortie souhaité
- si l'utilisateur ne choisit pas, conservez le préréglage par défaut et enregistrez-le dans la config
- n'empilez pas deux fois le même style ; si l'invite correspond déjà au préréglage, conservez l'invite telle quelle
Modèles
| Clé | ID complet du modèle | Idéal pour |
|---|---|---|
kling (par défaut) | kling-video/v2.1/pro/image-to-video | Mouvement réaliste, économique |
seedance | bytedance/seedance/v1/pro/image-to-video | Synchronisation audio native |
dop | higgsfield-ai/dop/standard | Physique optique Cinema Studio |
dop-preview | higgsfield-ai/dop/preview | Cinema Studio (niveau aperçu) |
Ce sont les ID de modèles confirmés dans la documentation officielle. Des modèles supplémentaires (Sora, Veo, Wan, etc.) peuvent être trouvés sur cloud.higgsfield.ai/explore. Pour en ajouter un, insérez-le dans
MODEL_IDSdansgenerate.pyet ajoutez un alias--model.Les crédits sont facturés uniquement pour les générations réussies ; les requêtes échouées et NSFW sont remboursées.
Configuration (première exécution uniquement)
cd "$SKILL_DIR" && uv sync
Obtenez des identifiants depuis cloud.higgsfield.ai (Clé API + Secret API), puis exportez-les en utilisant une de ces formes :
# Option A — combinée (recommandée)
export HF_KEY="votre-clé-api:votre-secret-api"
# Option B — variables séparées
export HF_API_KEY="votre-clé-api"
export HF_API_SECRET="votre-secret-api"
Workflow de l'Agent
1. Interrogez l'utilisateur
Avant de générer la vidéo, j'ai besoin de savoir :
🎬 Mode
- text-to-video (invite uniquement) ou image-to-video (déposez des images dans input/)
- par défaut : auto-détection
🎛️ Préréglage (par défaut : cinematic)
- cinematic · social-hook · motion-design-ad · ecommerce-ad · brand-story · product-360
- vérifiez le choix avant d'écrire config.json
- si omis, conservez le préréglage par défaut et enregistrez ce choix
🤖 Modèle (par défaut : kling)
kling · seedance · dop · dop-preview
Recommandation : kling pour la vitesse/coût, seedance pour la qualité
💬 Invite (obligatoire)
Décrivez le mouvement ou la scène, par exemple :
"slow cinematic push-in, warm golden hour light, subtle camera drift"
⚙️ Paramètres
- duration — durée de la vidéo en secondes (par défaut : 6, plage : 3–16)
- aspect_ratio — 16:9 · 9:16 · 1:1 (par défaut : 16:9)
- resolution — 720p · 1080p (par défaut : 1080p)
Attendez la réponse de l'utilisateur avant de continuer.
2. Modifiez config.json
Écrivez ou mettez à jour $SKILL_DIR/config.json en fonction des choix de l'utilisateur.
Définissez preset explicitement, même lors de l'utilisation de la valeur par défaut.
3. (image-to-video uniquement) Placez les images
Copiez les images sources dans $SKILL_DIR/input/. Formats supportés : .jpg .jpeg .png .webp
4. Exécutez
cd "$SKILL_DIR" && uv run python scripts/generate.py --config config.json
5. Rapportez les résultats
Informez l'utilisateur :
- Chemin(s) du fichier de sortie dans
output/ - Modèle utilisé et coût approximatif en crédits
- Durée et résolution de la vidéo
Référence de Configuration
| Clé | Valeurs | Par défaut | Description |
|---|---|---|---|
input_dir | chemin | ./input | Images sources (image-to-video uniquement) |
output_dir | chemin | ./output | Où les MP4 sont écrits |
mode | auto · text-to-video · image-to-video | auto | Mode de génération |
preset | cinematic · social-hook · motion-design-ad · ecommerce-ad · brand-story · product-360 | cinematic | Surcouche de préréglage créatif |
model | kling · seedance · dop · dop-preview | kling | Modèle à utiliser |
prompt | chaîne | (obligatoire) | Description du mouvement ou de la scène |
duration | entier 3–16 | 5 | Durée de la vidéo en secondes |
aspect_ratio | 16:9 · 9:16 · 1:1 | 16:9 | Ratio d'aspect de sortie |
extra_params | objet | {} | Paramètres de passage direct à l'API du modèle |
Invocations Courantes
# Texte-vers-vidéo avec le modèle par défaut (kling)
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "drone shot over misty mountains at sunrise" --duration 8
# Image-vers-vidéo avec Kling (déposez d'abord les images dans input/)
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "slow cinematic push-in, golden hour light" --model kling
# Qualité supérieure : Seedance
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "aerial pull-back over a foggy city at dawn" --model seedance
# Vidéo verticale pour Reels/TikTok
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "talking head, natural bokeh background" \
--aspect-ratio 9:16 --model kling
# Brouillon rapide : résolution inférieure, clip plus court
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "product reveal on dark background" \
--resolution 720p --duration 4 --model dop-preview
Sortie
Chaque tâche écrit un fichier .mp4 dans output_dir :
- texte-vers-vidéo :
output.mp4 - image-vers-vidéo :
<nom_image>.mp4par image d'entrée
vs animate-image
animate-image | video-generator | |
|---|---|---|
| Fournisseur | fal.ai | Higgsfield |
| Mode | image→vidéo uniquement | texte→vidéo + image→vidéo |
| Modèle | LTX-2.3 Fast (fixe) | Kling, Sora, Veo, Wan, Seedance, MiniMax |
| Vitesse | Très rapide | Dépend du modèle |
| Résolution max | 4K | 1080p |
| Contrôles cinématographiques | Non | Via extra_params |
Utilisez animate-image pour des clips rapides, économiques et haute résolution à partir d'images.
Utilisez video-generator lorsque vous avez besoin de texte-vers-vidéo, de choix de modèle ou des
contrôles physiques Cinema Studio de Higgsfield.
Notes sur l'API
La compétence communique directement avec l'API REST Higgsfield (cloud.higgsfield.ai).
Les chemins des points de terminaison des modèles sont définis dans MODEL_ENDPOINTS en haut de generate.py.
Si Higgsfield met à jour une route, remplacez-la via la config "extra_params" ou mettez à jour la
constante — aucun autre changement n'est nécessaire.