fal-ai-media

Génération de médias fal.ai

Compétence sujette à évolution rapide. Les identifiants de modèles fal.ai, les tarifs, les paramètres d'entrée et les noms d'outils MCP changent fréquemment. Recherchez ou récupérez les métadonnées du modèle actuel avant de promettre un modèle, un paramètre, un format de sortie ou un coût spécifique.

Générez des images, des vidéos et de l'audio en utilisant les modèles fal.ai via MCP.

Quand activer

• L'utilisateur souhaite générer des images à partir de descriptions textuelles
• Créer des vidéos à partir de texte ou d'images
• Générer de la parole, de la musique ou des effets sonores
• Toute tâche de génération de médias
• L'utilisateur dit "générer une image", "créer une vidéo", "texte vers parole", "créer une vignette" ou similaire

Prérequis MCP

Le serveur MCP fal.ai doit être configuré. Ajoutez-le à ~/.claude.json :

"fal-ai": {
  "command": "npx",
  "args": ["-y", "fal-ai-mcp-server"],
  "env": { "FAL_KEY": "VOTRE_CLE_FAL_ICI" }
}

Obtenez une clé API sur fal.ai.

Outils MCP

Le MCP fal.ai fournit ces outils :

• search — Rechercher des modèles disponibles par mot-clé
• find — Obtenir les détails et paramètres d'un modèle
• generate — Exécuter un modèle avec des paramètres
• result — Vérifier le statut d'une génération asynchrone
• status — Vérifier le statut d'un travail
• cancel — Annuler un travail en cours
• estimate_cost — Estimer le coût de génération
• models — Lister les modèles populaires
• upload — Télécharger des fichiers pour les utiliser comme entrées

---

Génération d'images

Nano Banana 2 (Rapide)

Idéal pour : itérations rapides, brouillons, texte-vers-image, édition d'images.

generate(
  app_id: "fal-ai/nano-banana-2",
  input_data: {
    "prompt": "un paysage urbain futuriste au coucher du soleil, style cyberpunk",
    "image_size": "landscape_16_9",
    "num_images": 1,
    "seed": 42
  }
)

Nano Banana Pro (Haute fidélité)

Idéal pour : images de production, réalisme, typographie, prompts détaillés.

generate(
  app_id: "fal-ai/nano-banana-pro",
  input_data: {
    "prompt": "photo professionnelle de casque sans fil sur surface en marbre, éclairage de studio",
    "image_size": "square",
    "num_images": 1,
    "guidance_scale": 7.5
  }
)

Paramètres d'image courants

Paramètre	Type	Options	Notes
prompt	chaîne	requis	Décrivez ce que vous voulez
image_size	chaîne	square, portrait_4_3, landscape_16_9, portrait_16_9, landscape_4_3	Format d'image
num_images	nombre	1-4	Combien en générer
seed	nombre	tout entier	Reproductibilité
guidance_scale	nombre	1-20	À quel point suivre le prompt (plus élevé = plus littéral)

Édition d'images

Utilisez Nano Banana 2 avec une image d'entrée pour l'inpainting, l'outpainting ou le transfert de style :

# Téléchargez d'abord l'image source
upload(file_path: "/chemin/vers/image.png")

# Ensuite, générez avec une image en entrée
generate(
  app_id: "fal-ai/nano-banana-2",
  input_data: {
    "prompt": "même scène mais en style aquarelle",
    "image_url": "<url_telechargee>",
    "image_size": "landscape_16_9"
  }
)

---

Génération vidéo

Seedance 1.0 Pro (ByteDance)

Idéal pour : texte-vers-vidéo, image-vers-vidéo avec une qualité de mouvement élevée.

generate(
  app_id: "fal-ai/seedance-1-0-pro",
  input_data: {
    "prompt": "un survol par drone d'un lac de montagne à l'heure dorée, cinématographique",
    "duration": "5s",
    "aspect_ratio": "16:9",
    "seed": 42
  }
)

Kling Video v3 Pro

Idéal pour : texte/image-vers-vidéo avec génération audio native.

generate(
  app_id: "fal-ai/kling-video/v3/pro",
  input_data: {
    "prompt": "vagues de l'océan s'écrasant sur une côte rocheuse, nuages dramatiques",
    "duration": "5s",
    "aspect_ratio": "16:9"
  }
)

Veo 3 (Google DeepMind)

Idéal pour : vidéo avec son généré, haute qualité visuelle.

generate(
  app_id: "fal-ai/veo-3",
  input_data: {
    "prompt": "un marché animé dans une rue de Tokyo la nuit, enseignes au néon, bruit de foule",
    "aspect_ratio": "16:9"
  }
)

Image-vers-vidéo

Partez d'une image existante :

generate(
  app_id: "fal-ai/seedance-1-0-pro",
  input_data: {
    "prompt": "la caméra effectue un zoom arrière lent, un vent doux agite les arbres",
    "image_url": "<url_image_telechargee>",
    "duration": "5s"
  }
)

Paramètres vidéo

Paramètre	Type	Options	Notes
prompt	chaîne	requis	Décrivez la vidéo
duration	chaîne	"5s", "10s"	Durée de la vidéo
aspect_ratio	chaîne	"16:9", "9:16", "1:1"	Ratio d'image
seed	nombre	tout entier	Reproductibilité
image_url	chaîne	URL	Image source pour image-vers-vidéo

---

Génération audio

CSM-1B (Parole conversationnelle)

Synthèse vocale avec une qualité naturelle et conversationnelle.

generate(
  app_id: "fal-ai/csm-1b",
  input_data: {
    "text": "Bonjour, bienvenue dans la démo. Laissez-moi vous montrer comment cela fonctionne.",
    "speaker_id": 0
  }
)

ThinkSound (Vidéo-vers-audio)

Générez un audio correspondant à partir d'un contenu vidéo.

generate(
  app_id: "fal-ai/thinksound",
  input_data: {
    "video_url": "<url_video>",
    "prompt": "sons ambiants de forêt avec des oiseaux qui chantent"
  }
)

ElevenLabs (via API, sans MCP)

Pour une synthèse vocale professionnelle, utilisez ElevenLabs directement :

import os
import requests

resp = requests.post(
    "https://api.elevenlabs.io/v1/text-to-speech/<voice_id>",
    headers={
        "xi-api-key": os.environ["ELEVENLABS_API_KEY"],
        "Content-Type": "application/json"
    },
    json={
        "text": "Votre texte ici",
        "model_id": "eleven_turbo_v2_5",
        "voice_settings": {"stability": 0.5, "similarity_boost": 0.75}
    }
)
with open("output.mp3", "wb") as f:
    f.write(resp.content)

Audio génératif VideoDB

Si VideoDB est configuré, utilisez son audio génératif :

# Génération de voix
audio = coll.generate_voice(text="Votre narration ici", voice="alloy")

# Génération de musique
music = coll.generate_music(prompt="musique de fond électronique entraînante", duration=30)

# Effets sonores
sfx = coll.generate_sound_effect(prompt="coup de tonnerre suivi de pluie")

---

Estimation des coûts

Avant de générer, vérifiez le coût estimé :

estimate_cost(
  estimate_type: "unit_price",
  endpoints: {
    "fal-ai/nano-banana-pro": {
      "unit_quantity": 1
    }
  }
)

Découverte de modèles

Trouvez des modèles pour des tâches spécifiques :

search(query: "texte vers vidéo")
find(endpoint_ids: ["fal-ai/seedance-1-0-pro"])
models()

Conseils

• Utilisez seed pour des résultats reproductibles lors de l'itération sur les prompts
• Commencez par des modèles moins coûteux (Nano Banana 2) pour itérer sur les prompts, puis passez aux Pro pour les versions finales
• Pour la vidéo, gardez les prompts descriptifs mais concis — concentrez-vous sur le mouvement et la scène
• L'image-vers-vidéo produit des résultats plus contrôlés que le texte-vers-vidéo pur
• Vérifiez estimate_cost avant d'exécuter des générations vidéo coûteuses

Compétences associées

• tasteforge-video — Distillation de goût et planification de modalité hors ligne. Ses candidats de point de terminaison et ses manifestes de requête sont uniquement de référence, et ne sont ni des tâches soumises ni des workflows Fal sauvegardés. Un transfert TasteForge n'autorise pas le téléchargement ou la génération ; utilisez un workflow fournisseur autorisé séparément et vérifiez son schéma de point de terminaison actuel avant d'exécuter.
• videodb — Traitement, édition et diffusion vidéo
• video-editing — Flux de travail de montage vidéo assisté par IA
• content-engine — Création de contenu pour les plateformes sociales