Introduction
# 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:
```bash export FAL_KEY="your-api-key" ```
Or via clawdbot config:
```bash 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
```python 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:
```bash 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.