Fal Ai Media
Generate images, video, or audio through fal.ai MCP tools when your agent needs AI media without bespoke API glue code.
Overview
fal-ai-media is an agent skill for the Build phase that generates images, video, and audio via the fal.ai MCP server with search, generate, and async result tooling.
Install
npx skills add https://github.com/affaan-m/everything-claude-code --skill fal-ai-mediaWhat is this skill?
- Unified fal.ai path for image, video, and audio (text-to-image, text/image-to-video, TTS, video-to-audio)
- MCP tools: search, find, generate, result, status, cancel, estimate_cost
- Documents `fal-ai-mcp-server` via npx and `FAL_KEY` in `~/.claude.json`
- Explicit drift warning: verify current model IDs and pricing before promising outputs
- Activates on natural requests like generate image, create video, or text to speech
- Documents seven MCP tool roles: search, find, generate, result, status, cancel, estimate_cost
Adoption & trust: 4.1k installs on skills.sh; 210k GitHub stars; 1/3 security scanners passed (skills.sh audits).
What problem does it solve?
You want AI-generated media in an agent session but do not want to maintain separate scripts for each fal model and async job.
Who is it for?
Indie builders already on Claude Code with a fal.ai key who need repeatable image, video, or audio generation inside the agent.
Skip if: Production pipelines requiring fixed SLAs and pinned models without live metadata checks, or workflows with no MCP support.
When should I use this skill?
User wants images, videos, or audio from AI; says generate image, create video, text to speech, make a thumbnail, or similar media tasks.
What do I get? / Deliverables
Your agent configures fal.ai MCP, picks up-to-date models via search/find, runs generate jobs, and retrieves outputs with status/result handling.
- Generated image, video, or audio assets
- Job status and cost estimates via MCP
Recommended Skills
Journey fit
Media generation via MCP lands in Build as you wire generative capabilities into the product or marketing assets. integrations reflects MCP server setup, FAL_KEY env, and tool calls (`search`, `generate`, `result`) rather than hand-rolled frontend UI.
How it compares
MCP-integrated media generation skill, not a local Stable Diffusion or FFmpeg-only workflow.
Common Questions / FAQ
Who is fal-ai-media for?
Solo builders using Claude Code who want fal.ai image, video, and audio generation through MCP tools rather than custom REST clients.
When should I use fal-ai-media?
During Build when integrating generative assets—thumbnails, clips, TTS—for product UI, demos, or content while the user asks to generate image, video, or speech.
Is fal-ai-media safe to install?
It requires a fal.ai API key and network access to paid generation; review the Security Audits panel on this page and rotate keys if the MCP config is shared.
SKILL.md
READMESKILL.md - Fal Ai Media
# fal.ai Media Generation > **Drift-prone skill.** fal.ai model IDs, pricing, inputs, and MCP tool names > change quickly. Search or fetch the current model metadata before promising a > specific model, parameter, output format, or cost. Generate images, videos, and audio using fal.ai models via MCP. ## When to Activate - User wants to generate images from text prompts - 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 fal.ai MCP server must be configured. Add 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( app_id: "fal-ai/nano-banana-2", input_data: { "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( app_id: "fal-ai/nano-banana-pro", input_data: { "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`, `portrait_4_3`, `landscape_16_9`, `portrait_16_9`, `landscape_4_3` | 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( app_id: "fal-ai/nano-banana-2", input_data: { "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( app_id: "fal-ai/seedance-1-0-pro", input_data: { "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( app_id: "fal-ai/kling-video/v3/pro", input_data: { "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( app_id: "fal-ai/veo-3", input_data: { "prompt": "a bustling Tokyo street market at night, ne