Skip to main content
Agent skill

Fal Ai Media

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.

Get started

Get the complete skill folder, including its scripts and reference files.

·

When to use this skill

Use Fal Ai Media when an AI agent needs a reusable SKILL.md workflow for this job: 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.

When not to use it

Skip Fal Ai Media when the task is outside the creativity category, or when a more specific skill in this directory already covers the same workflow with clearer triggers.

How to install

Where will you use it?

Install scope
Claude Code folder setup
mkdir -p ~/.claude/skills/fal-ai-media
# Save SKILL.md to ~/.claude/skills/fal-ai-media/SKILL.md
  1. Claude Code personal install: place the skill and its bundled files at ~/.claude/skills/fal-ai-media/SKILL.md. For a shared project, commit the folder at .claude/skills/fal-ai-media/ instead.
  2. Current Claude Code detects SKILL.md changes in watched directories during the session. If you just created a top-level skills directory, run /reload-skills. Check that the skill is listed before testing its trigger.
  3. For Claude chat or Cowork in the Desktop app, manage uploaded skills in Customize > Skills; copying files into a local Claude Code folder is not a Desktop install. Other agents may use different install locations.

Full install guide for Claude, Cursor, and Codex →

Try a starter prompt

After installing the skill, paste this starter prompt into your agent to verify it triggers on a small task.

Starter prompt
Use the Fal Ai Media skill for this task: Use Fal Ai Media when this documented workflow matches the task. Confirm any required inputs or files before making changes.

What supports this recommendation?

76/100 provisional content score. This measures documentation, practical detail and source signals. It is not a measured task success rate or a security certification.

Documentation
85/100
Practical detail
76/100
Source evidence
63/100
Source signals
70/100
Model compatibility evidence
  • claudeinferred

    The skill text mentions Claude or a closely associated term. This is keyword-derived compatibility; no hands-on model test is recorded.

  • chatgptuntested

    No model-specific signal or recorded compatibility test was found.

  • geminiuntested

    No model-specific signal or recorded compatibility test was found.

  • copilotuntested

    No model-specific signal or recorded compatibility test was found.

  • llamauntested

    No model-specific signal or recorded compatibility test was found.

  • perplexityuntested

    No model-specific signal or recorded compatibility test was found.

  • mistraluntested

    No model-specific signal or recorded compatibility test was found.

  • grokuntested

    No model-specific signal or recorded compatibility test was found.

Inferred compatibility is based on content signals. Check the app, its available tools and setup requirements before running a skill.

What this skill does

# 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, neon signs, crowd noise", "aspect_ratio": "16:9" } ) ```

### Image-to-Video Start from an existing image:

``` generate( app_id: "fal-ai/seedance-1-0-pro", input_data: { "prompt": "camera slowly zooms out, gentle wind moves the trees", "image_url": "<uploaded_image_url>", "duration": "5s" } ) ```

### Video Parameters

| Param | Type | Options | Notes | |-------|------|---------|-------| | `prompt` | string | required | Describe the video | | `duration` | string | `"5s"`, `"10s"` | Video length | | `aspect_ratio` | string | `"16:9"`, `"9:16"`, `"1:1"` | Frame ratio | | `seed` | number | any integer | Reproducibility | | `image_url` | string | URL | Source image for image-to-video |

---

## Audio Generation

### CSM-1B (Conversational Speech) Text-to-speech with natural, conversational quality.

``` generate( app_id: "fal-ai/csm-1b", input_data: { "text": "Hello, welcome to the demo. Let me show you how this works.", "speaker_id": 0 } ) ```

### ThinkSound (Video-to-Audio) Generate matching audio from video content.

``` generate( app_id: "fal-ai/thinksound", input_data: { "video_url": "<video_url>", "prompt": "ambient forest sounds with birds chirping" } ) ```

### ElevenLabs (via API, no MCP) For professional voice synthesis, use ElevenLabs directly:

```python import os import requests

resp = requests.post( "https://api.elevenlabs.io/v1/text-to-speech/<voice_id>", headers={ "xi-api-key": os.environ["ELEVENLABS_API_KEY"], "Content-Type": "application/json" }, json={ "text": "Your text here", "model_id": "eleven_turbo_v2_5", "voice_settings": {"stability": 0.5, "similarity_boost": 0.75} } ) with open("output.mp3", "wb") as f: f.write(resp.content) ```

### VideoDB Generative Audio If VideoDB is configured, use its generative audio:

```python # Voice generation audio = coll.generate_voice(text="Your narration here", voice="alloy")

# Music generation music = coll.generate_music(prompt="upbeat electronic background music", duration=30)

# Sound effects sfx = coll.generate_sound_effect(prompt="thunder crack followed by rain") ```

---

## Cost Estimation

Before generating, check estimated cost:

``` estimate_cost( estimate_type: "unit_price", endpoints: { "fal-ai/nano-banana-pro": { "unit_quantity": 1 } } ) ```

## Model Discovery

Find models for specific tasks:

``` search(query: "text to video") find(endpoint_ids: ["fal-ai/seedance-1-0-pro"]) models() ```

## Tips

- Use `seed` for reproducible results when iterating on prompts - Start with lower-cost models (Nano Banana 2) for prompt iteration, then switch to Pro for finals - For video, keep prompts descriptive but concise — focus on motion and scene - Image-to-video produces more controlled results than pure text-to-video - Check `estimate_cost` before running expensive video generations

## Related Skills

- `tasteforge-video` — Offline taste distillation and modality planning. Its endpoint candidates and request manifests are reference-only, not submitted jobs or saved Fal workflows. A TasteForge handoff does not authorize upload or generation; use a separately authorized provider workflow and verify its current endpoint schema before executing. - `videodb` — Video processing, editing, and streaming - `video-editing` — AI-powered video editing workflows - `content-engine` — Content creation for social platforms

Intended uses

  • Use Fal Ai Media when this documented workflow matches the task.

Implementation notes

  • Use seed for reproducible results when iterating on prompts
  • Start with lower-cost models (Nano Banana 2) for prompt iteration, then switch to Pro for finals
  • For video, keep prompts descriptive but concise — focus on motion and scene
  • Image-to-video produces more controlled results than pure text-to-video
  • Check estimatecost before running expensive video generations

Try it, then tell us how it went

A copied prompt does not tell us whether the task worked. Report your result after checking the output. We collect your tool and outcome, never your files or prompt.