demerzels-lab/fal-api

fal.ai API Skill

Generate images, videos, and transcripts using fal.ai's API with support for FLUX, Stable Diffusion, Whisper, and more.

Features

• Queue-based async generation (submit → poll → result)
• Support for 600+ AI models
• Image generation (FLUX, SDXL, Recraft)
• Video generation (MiniMax, WAN)
• Speech-to-text (Whisper)
• Stdlib-only dependencies (no fal_client required)

Setup

1. Get your API key from https://fal.ai/dashboard/keys
2. Configure with:

export FAL_KEY="your-api-key"

Or via clawdbot config:

clawdbot config set skill.fal_api.key YOUR_API_KEY

Usage

Interactive Mode

You: Generate a cyberpunk cityscape with FLUX
Klawf: Creates the image and returns the URL

Python Script

from fal_api import FalAPI

api = FalAPI()

# Generate and wait
urls = api.generate_and_wait(
    prompt="A serene Japanese garden",
    model="flux-dev"
)
print(urls)

Available Models

| Model | Endpoint | Type | | ------------- | ------------------------------------- | ------------ | | flux-schnell | fal-ai/flux/schnell | Image (fast) | | flux-dev | fal-ai/flux/dev | Image | | flux-pro | fal-ai/flux-pro/v1.1-ultra | Image (2K) | | fast-sdxl | fal-ai/fast-sdxl | Image | | recraft-v3 | fal-ai/recraft-v3 | Image | | sd35-large | fal-ai/stable-diffusion-v35-large | Image | | minimax-video | fal-ai/minimax-video/image-to-video | Video | | wan-video | fal-ai/wan/v2.1/1.3b/text-to-video | Video | | whisper | fal-ai/whisper | Audio |

For the full list, run:

python3 fal_api.py --list-models

Parameters

| Parameter | Type | Default | Description | | ---------- | ---- | ---------------- | -------------------------------------------------- | | prompt | str | required | Image/video description | | model | str | "flux-dev" | Model name from table above | | image_size | str | "landscape_16_9" | Preset: square, portrait_4_3, landscape_16_9, etc. | | num_images | int | 1 | Number of images to generate | | seed | int | None | Random seed for reproducibility |

Credits

Built following the krea-api skill pattern. Uses fal.ai's queue-based API for reliable async generation.