Skills fal.ai

Claude Code Skill for fal.ai - Generate AI Images, Videos, Audio & 3D

Based on the fal-ai-community/skills project by @ilker

---

GitHub Project Info

Suggested Repository Name: skills-fal-ai

Title: Skills fal.ai - Claude Code Skill for AI Generation

Description:

Claude Code skill for generating AI images, videos, audio and 3D content using fal.ai’s 500+ models. Supports Kling V3, FLUX.2, Veo 3.1, MiniMax, Hunyuan 3D and more.

Topics/Tags: claude-code fal-ai ai-generation text-to-image text-to-video text-to-speech 3d-generation kling flux hunyuan skill

---

Features

• 500+ AI Models - Latest image, video, audio, and 3D generation models
• Queue-based System - Reliable async processing with automatic polling
• File Upload - Built-in CDN upload for local files
• Model Discovery - Search and explore available models
• Updated February 2026 - Kling V3, FLUX.2 Klein, Grok Imagine, Veo 3.1, and more

Installation

Option 1: Clone from GitHub

git clone https://github.com/YOUR_USERNAME/skills-fal-ai.git
cp -r skills-fal-ai/fal-generate ~/.claude/skills/

Option 2: Direct Copy

# Copy the fal-generate folder to your Claude skills directory
cp -r fal-generate ~/.claude/skills/

Prerequisites

# Set your fal.ai API key
export FAL_KEY="your-api-key"

# Install jq (required for JSON parsing)
brew install jq  # macOS
apt-get install jq  # Ubuntu/Debian

Quick Start

cd ~/.claude/skills/fal-generate

# Generate an Image (Kling V3)
./scripts/generate.sh -m fal-ai/kling-image/v3/text-to-image \
  -p "A majestic castle at sunset, cinematic lighting" -w

# Generate a Video (Kling V3 Pro with audio)
./scripts/generate.sh -m fal-ai/kling-video/v3/pro/text-to-video \
  -p "A butterfly emerging from a cocoon in slow motion" --duration 5 -w

# Generate Speech (MiniMax)
./scripts/generate.sh -m fal-ai/minimax/speech-2.8-hd \
  -t "Hello! Welcome to fal.ai, the AI cloud platform." -w

# Generate 3D Model (Hunyuan 3D)
./scripts/generate.sh -m fal-ai/hunyuan-3d/v3.1/pro/text-to-3d \
  -p "A detailed medieval sword with ornate handle" -w

# Animate an Image (Kling O3)
./scripts/generate.sh -m fal-ai/kling-video/o3/pro/image-to-video \
  --image-url "https://example.com/portrait.jpg" \
  -p "Gentle wind blowing through hair, subtle smile" -w

Directory Structure

fal-generate/
├── README.md           # This file
├── SKILL.md            # Detailed skill documentation
├── MODELS.md           # Complete model catalog (500+ models)
└── scripts/
    ├── generate.sh     # Main generation script
    ├── upload.sh       # File upload to fal CDN
    ├── poll.sh         # Queue status polling
    └── models.sh       # Model discovery & search

Featured Models (February 2026)

Image Generation (Top Picks)

Video Generation (Top Picks)

Audio (Top Picks)

3D Generation (Top Picks)

Scripts Reference

generate.sh - Main Generation

./scripts/generate.sh --model  [options]

Options:
  -m, --model       Model endpoint (required)
  -p, --prompt      Text prompt for generation
  -t, --text        Text for TTS models
  --image-url       Input image URL
  --video-url       Input video URL
  --audio-url       Input audio URL
  --aspect-ratio    16:9, 9:16, 1:1, 4:3, 3:4
  --duration        Video length in seconds
  --seed            Seed for reproducibility
  -w, --wait        Poll until completion
  -a, --async       Return request ID only
  --param           Extra param (key=value)

upload.sh - File Upload

./scripts/upload.sh /path/to/file.jpg
# Returns: https://fal.ai/cdn/...

poll.sh - Status Polling

./scripts/poll.sh   [--timeout 600]

models.sh - Model Discovery

./scripts/models.sh --featured              # List featured models
./scripts/models.sh --search "video"        # Search by keyword
./scripts/models.sh --category text-to-image # Filter by category
./scripts/models.sh --schema      # Get API schema
./scripts/models.sh --pricing     # Get pricing

Full Model Catalog

See MODELS.md for the complete catalog of 500+ models organized by:

• Release date (February 2026 → December 2024)
• Category (Image, Video, Audio, 3D, Text)
• Use case recommendations

Publishing to GitHub

skills-fal-ai/
├── README.md
├── LICENSE
└── fal-generate/
    ├── README.md
    ├── SKILL.md
    ├── MODELS.md
    └── scripts/
        ├── generate.sh
        ├── upload.sh
        ├── poll.sh
        └── models.sh

Credits

• Original Skill: fal-ai-community/skills by @ilker
• fal.ai Platform: https://fal.ai
• fal.ai Documentation: https://docs.fal.ai
• Model Catalog: Updated February 2026

License

MIT License - See LICENSE file.

---

Made with fal.ai