fal

⚠Review·Scanned 2/17/2026

This skill enables running fal.ai generative models (search, schema, run, status, result, upload) and saves outputs to ~/.fal/sessions/${CLAUDE_SESSION_ID}. It instructs executing shell commands (curl, mkdir), making network calls to https://api.fal.ai/https://queue.fal.run, and requires the FAL_KEY environment variable.

from clawhub.ai·v1.0.1·9.8 KB·0 installs
Scanned from 1.0.1 at 58b8d9b · Transparency log ↗
$ vett add clawhub.ai/apekshik/falReview findings below

fal-skill

A Claude Code skill for running fal.ai generative AI models - image generation, video, audio, 3D, and more.

Installation

git clone https://github.com/fal-ai/fal-skill ~/.claude/skills/fal

Setup

  1. Get an API key from fal.ai/dashboard/keys

  2. Add to your shell config (~/.zshrc or ~/.bashrc):

    export FAL_KEY="your-key-here"

  3. Reload your shell:

    source ~/.zshrc

Usage

Commands

CommandDescription
/fal search <query>Search 600+ models
/fal schema <model_id>Get input/output schema
/fal run <model_id> --param valueRun a model
/fal status <model_id> <request_id>Check job status
/fal result <model_id> <request_id>Get job result
/fal upload <file>Upload file to fal CDN

Examples

# Search for models
/fal search video

# See what inputs a model accepts
/fal schema fal-ai/flux-2

# Generate an image
/fal run fal-ai/flux-2 --prompt "a cat in space"

Or just ask Claude naturally:

"Generate an image of a sunset over mountains"

"Turn this photo into a video"

"What image models are available?"

Popular Models

ModelCategory
fal-ai/flux-2Text to image
fal-ai/flux-2-proText to image (high quality)
fal-ai/kling-video/v2/image-to-videoImage to video
fal-ai/minimax/video-01/image-to-videoImage to video
fal-ai/whisperSpeech to text

See models-reference.md for a full list.

How It Works

This skill teaches Claude how to interact with fal.ai APIs using curl. When you ask Claude to generate media, it:

  1. Searches for appropriate models (if needed)
  2. Fetches the model schema to understand required inputs
  3. Submits the job to fal's queue
  4. Polls for completion
  5. Downloads results to your machine

Links

License

MIT