介绍
# fal.ai API Skill
使用 fal.ai 的 API 生成图像、视频和文本记录，支持 FLUX、Stable Diffusion、Whisper 等。
## 功能
- 基于队列的异步生成（提交 → 轮询 → 结果） - 支持 600+ 种 AI 模型 - 图像生成 (FLUX, SDXL, Recraft) - 视频生成 (MiniMax, WAN) - 语音转文本 (Whisper) - 仅依赖标准库（不需要 `fal_client`）
## 设置
1. 从 https://fal.ai/dashboard/keys 获取您的 API 密钥 2. 使用以下命令进行配置：
```bash export FAL_KEY="your-api-key" ```
或通过 clawdbot 配置：
```bash clawdbot config set skill.fal_api.key YOUR_API_KEY ```
## 用法
### 交互模式
``` You: Generate a cyberpunk cityscape with FLUX Klawf: Creates the image and returns the URL ```
### Python 脚本
```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) ```
### 可用模型
| 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 |
要获取完整列表，请运行：
```bash python3 fal_api.py --list-models ```
## 参数
| Parameter | Type | Default | Description | | ---------- | ---- | ---------------- | -------------------------------------------------- | | prompt | str | required | 图像/视频描述 | | model | str | "flux-dev" | 上表中的模型名称 | | image_size | str | "landscape_16_9" | 预设：square, portrait_4_3, landscape_16_9 等. | | num_images | int | 1 | 要生成的图像数量 | | seed | int | None | 用于复现性的随机种子 |
## 致谢
本技能参照 krea-api 技能模式构建。使用 fal.ai 的基于队列的 API 实现可靠的异步生成。