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
- Configure with:
CODEBLOCK0
Or via clawdbot config:
CODEBLOCK1
Usage
Interactive Mode
CODEBLOCK2
Python Script
CODEBLOCK3
Available Models
| Model | Endpoint | Type |
|---|
| flux-schnell | INLINECODE1 | 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:
CODEBLOCK4
Parameters
| Parameter | Type | Default | Description |
|---|
| prompt | str | required | Image/video description |
| model |
str | "flux-dev" | Model name from table above |
| image
size | str | "landscape16
9" | Preset: square, portrait4
3, landscape16_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.
fal.ai API 技能
使用 fal.ai 的 API 生成图像、视频和转录文本，支持 FLUX、Stable Diffusion、Whisper 等模型。
功能特性
- - 基于队列的异步生成（提交 → 轮询 → 获取结果）
- 支持 600+ AI 模型
- 图像生成（FLUX、SDXL、Recraft）
- 视频生成（MiniMax、WAN）
- 语音转文本（Whisper）
- 仅依赖标准库（无需 fal_client）
配置方法
- 1. 从 https://fal.ai/dashboard/keys 获取 API 密钥
- 通过以下方式配置：
bash
export FAL_KEY=your-api-key
或通过 clawdbot 配置：
bash
clawdbot config set skill.falapi.key YOURAPI_KEY
使用方法
交互模式
你：生成一张赛博朋克城市景观图，使用 FLUX 模型
Klawf：创建图像并返回 URL
Python 脚本
python
from fal_api import FalAPI
api = FalAPI()
生成并等待结果
urls = api.generate
andwait(
prompt=一个宁静的日本花园,
model=flux-dev
)
print(urls)
可用模型
| 模型名称 | 端点地址 | 类型 |
|---|
| flux-schnell | fal-ai/flux/schnell | 图像（快速） |
| flux-dev |
fal-ai/flux/dev | 图像 |
| flux-pro | fal-ai/flux-pro/v1.1-ultra | 图像（2K） |
| fast-sdxl | fal-ai/fast-sdxl | 图像 |
| recraft-v3 | fal-ai/recraft-v3 | 图像 |
| sd35-large | fal-ai/stable-diffusion-v35-large | 图像 |
| minimax-video | fal-ai/minimax-video/image-to-video | 视频 |
| wan-video | fal-ai/wan/v2.1/1.3b/text-to-video | 视频 |
| whisper | fal-ai/whisper | 音频 |
查看完整列表，请运行：
bash
python3 fal_api.py --list-models
参数说明
| 参数 | 类型 | 默认值 | 描述 |
|---|
| prompt | str | 必填 | 图像/视频描述 |
| model |
str | flux-dev | 上表中的模型名称 |
| image
size | str | landscape16
9 | 预设尺寸：square、portrait4
3、landscape16_9 等 |
| num_images | int | 1 | 生成图像数量 |
| seed | int | None | 随机种子，用于结果复现 |
致谢
基于 krea-api 技能模式构建。使用 fal.ai 基于队列的 API 实现可靠的异步生成。
