fal-ai-media

fal.ai Media Generation

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 ~/.codex.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.

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, 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)