用途
fal-api 是一个用于调用 fal.ai API 的技能，主要面向需要通过 API 生成图像、视频和音频转录的场景。它封装了 fal.ai 的队列式异步生成流程，让用户可以用统一的方式访问多种 AI 模型。
主要能力
- 基于队列的异步生成：提交任务 → 轮询状态 → 获取结果。
- 支持 600 多个 AI 模型。
- 图像生成：FLUX、SDXL、Recraft 等。
- 视频生成：MiniMax、WAN 等。
- 语音转文字：Whisper。
- 仅依赖 Python 标准库，无需安装 fal_client。
可用模型
| 模型 | 端点 | 类型 |
|---|---|---|
| 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 | 音频 |
查看完整列表可运行：
python3 fal_api.py --list-models
使用方式
设置
- 从 https://fal.ai/dashboard/keys 获取 API 密钥。
- 通过环境变量配置：
export FAL_KEY="your-api-key"
或通过 clawdbot 配置：
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 脚本
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)
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| prompt | str | 必填 | 图像/视频描述 |
| model | str | "flux-dev" | 上表中的模型名称 |
| image_size | str | "landscape_16_9" | 预设：square、portrait_4_3、landscape_16_9 等 |
| num_images | int | 1 | 生成图像数量 |
| seed | int | None | 用于复现的随机种子 |
适用场景
- 需要通过 API 批量或按需生成图像、视频。
- 需要将语音转写为文字。
- 希望在 Python 项目中以标准库方式调用 fal.ai 模型，避免额外依赖。
限制
- 需要有效的 fal.ai API 密钥。
- 具体模型的可用性、计费、速率限制和输出质量取决于 fal.ai 平台，资料中暂未提供相关信息。
- 资料中未提供错误处理、超时、并发控制等细节。