# Fal AI Media

Generate images, video and audio through the fal.ai MCP server.

- Repository: https://github.com/affaan-m/ECC (294725 stars)
- Category: Media
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add affaan-m/ECC --skill fal-ai-media -g -a claude-code -y`
Codex: `npx skills add affaan-m/ECC --skill fal-ai-media -g -a codex -y`
Cursor: `npx skills add affaan-m/ECC --skill fal-ai-media -g -a cursor -y`
Gemini CLI: `npx skills add affaan-m/ECC --skill fal-ai-media -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add affaan-m/ECC`

## Description

Unified media generation via fal.ai MCP, image, video, 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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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 `~/.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

The rest: https://github.com/affaan-m/ECC/blob/HEAD/.agents/skills/fal-ai-media/SKILL.md