affaan-m/fal-ai-media

Que fait fal-ai-media ?

Génération de médias unifiée via l'MCP de fal.ai — image, vidéo et audio. Couvre la génération texte-vers-image (Nano Banana, Ideogram, Bria, SD3.5), texte/image-vers-vidéo (Seedance, Kling, Veo 3, Runway), texte-vers-parole (CSM-1B, Whisper, Cartesia, ElevenLabs), et vidéo-vers-audio (ThinkSound). À utiliser lorsque l'utilisateur souhaite générer des images, vidéos ou audio avec l'IA.

Aperçu

Ce package expose une interface MCP (Model Context Protocol) pour les services de génération de médias de fal.ai, permettant aux assistants IA de générer des images, vidéos et fichiers audio en utilisant des modèles d'IA de pointe.

Installation

npm install @matthewhand/mcp-fal-ai-media
# ou
yarn add @matthewhand/mcp-fal-ai-media
# ou
pnpm add @matthewhand/mcp-fal-ai-media

Configuration

Définissez vos identifiants d'API fal.ai en tant que variables d'environnement :

FAL_KEY=votre_clé_api_fal_ai

Vous pouvez obtenir votre clé API depuis la console fal.ai.

Utilisation avec Claude Code

Ajoutez ce qui suit à votre fichier ~/.claude/installed.json :

{
  "mcpServers": {
    "fal-ai-media": {
      "command": "npx",
      "args": ["-y", "@matthewhand/mcp-fal-ai-media"]
    }
  }
}

Outils disponibles

Génération d'images

Méthode	Modèle	Description
generate_image	Nano Banana (XL)	Génération d'image générale rapide
generate_image_ideogram	Ideogram	Génération de texte fiable sur images
generate_image_bria	Bria	Génération d'image haute qualité
generate_image_sd35	SD3.5	Génération de détail fine
generate_image_fast	Nano Banana (Fast)	Génération d'image ultra-rapide

Génération vidéo

Méthode	Modèle	Description
generate_video_fast	Kling 1.5	Génération vidéo rapide
generate_video_seedance	Seedance	Haute qualité, contrôle via seed
generate_video_veo3	Veo 3	Sortie vidéo premium
generate_video_runway	Runway	Alternative supplémentaire

Génération audio

Méthode	Modèle	Description
generate_audio	CSM-1B	Génération de parole réaliste
generate_audio_whisper	Whisper	Génération de parole basique
generate_audio_cartesia	Cartesia	Sortie audio haute fidélité
generate_audio_elevenlabs	ElevenLabs	Voix réalistes premium

Audio depuis vidéo

Méthode	Modèle	Description
generate_audio_from_video	ThinkSound	Génère l'audio synchronisé pour une vidéo silencieuse

Paramètres avancés

Tous les outils de génération prennent en charge les paramètres optionnels suivants :

• seed : Valeur de graine pour la reproductibilité
• input : Entrées supplémentaires spécifiques au modèle (selon le modèle)
• image_size : Taille de sortie souhaitée (p. ex. "landscape_4_3", "square_hd")

Les prompts négatifs sont pris en charge là où le modèle le permet.

Exemple de flux de travail

1. Générer une image : generate_image_fast avec prompt "un chat avec un chapeau"
2. Animer en vidéo : Prendre l'URL de l'image et l'utiliser avec generate_video_fast
3. Ajouter une narration : generate_audio avec le script de la voix off
4. Synchroniser l'audio avec la vidéo : generate_audio_from_video pour ajouter l'audio à la vidéo générée

Licence

MIT