fal.ai Media Generation

--- name: fal-ai-media description: Unified media generation via fal.ai MCP : images, videos, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI. --- # fal.ai Media Generation Generate images, videos, and audio using fal.ai models via MCP. ## When to Activate - User wants to generate images from textprompts - Creating videos from text or images - Generating speech, music, or sound effects - Any media generation task - User says "generate image," "create video," "text to speech," "make a thumbnail," or similar ## MCP Requirement The fal.ai MCP server must be configured. Add the following to ~/.claude.json: ``json "fal-ai": { "command": "npx", "args": ["-y", "fal-ai-mcp-server"], "env": { "FAL_KEY": "YOUR_FAL_KEY_HERE" } } ` Get an API key at [fal.ai](https://fal.ai). ## MCP Tools The fal.ai MCP provides these tools: - search : Find available models by keyword - find : Get model details and parameters - generate : Run a model with parameters - result : Check async generation status - status : Check job status - cancel : Cancel a running job - estimate_cost : Estimate generation cost - models : List popular models - upload : Upload files for use as inputs --- ## Image Generation ### Nano Banana 2 (Fast) Best for: quick iterations, drafts, text-to-image, image editing. ` generate( model_name: "fal-ai/nano-banana-2", input: { "prompt": "a futuristic cityscape at sunset, cyberpunk style", "image_size": "landscape_16_9", "num_images": 1, "seed": 42 } ) ` ### Nano Banana Pro (High Fidelity) Best for: production images, realism, typography, detailed prompts. ` generate( model_name: "fal-ai/nano-banana-pro", input: { "prompt": "professional product photo of wireless headphones on marble surface, studio lighting", "image_size": "square", "num_images": 1, "guidance_scale": 7.5 } ) ` ### Common Image Parameters | Param | Type | Options | Notes | |-------|------|---------|-------| | prompt | string | required | Describe what you want | | image_size | string | square , portrait43, landscape169, portrait169, landscape43 | Aspect ratio | | num_images | number | 1-4 | How many to generate | | seed | number | any integer | Reproducibility | | guidance_scale | number | 1-20 | How closely to follow the prompt (higher = more literal) | ### Image Editing Use Nano Banana 2 with an input image for inpainting, outpainting, or style transfer: ` # First upload the source image upload(file_path: "/path/to/image.png") # Then generate with image input generate( model_name: "fal-ai/nano-banana-2", input: { "prompt": "same scene but in watercolor style", "image_url": "<uploaded_url>", "image_size": "landscape_16_9" } ) ` --- ## Video Generation ### Seedance 1.0 Pro (ByteDance) Best for: text-to-video, image-to-video with high motion quality. ` generate( model_name: "fal-ai/seedance-1-0-pro", input: { "prompt": "a drone flyover of a mountain lake at golden hour, cinematic", "duration": "5s", "aspect_ratio": "16:9", "seed": 42 } ) ` ### Kling Video v3 Pro Best for: text/image-to-video with native audio generation. ` generate( model_name: "fal-ai/kling-video/v3/pro", input: { "prompt": "ocean waves crashing on a rocky coast, dramatic clouds", "duration": "5s", "aspect_ratio": "16:9" } ) ` ### Veo 3 (Google DeepMind) Best for: video with generated sound, high visual quality. ` generate( model_name: "fal-ai/veo-3", input: { "prompt": "a bustling Tokyo street market at night, neon signs, crowd noise", "aspect_ratio": "16:9" } ) ` ### Image-to-Video Start from an existing image: ` generate( model_name: "fal-ai/seedance-1-0-pro", input: { "prompt": "camera slowly zooms out, gentle wind moves the trees", "image_url": "<uploaded_image_url>", "duration": "5s" } ) ` ### Video Parameters | Param | Type | Options | Notes | |-------|------|---------|-------| | prompt` | strin