fal-api 技能用于通过 fal.ai 的 API 生成图像、视频和音频转录内容，并支持 FLUX、Stable Diffusion、Whisper 等多种模型。
用途
该技能面向需要通过 fal.ai 平台调用 AI 模型生成媒体内容的场景。它封装了基于队列的异步生成流程，即先提交任务、再轮询状态、最后获取结果，从而支持可靠的异步生成。
主要能力
- 基于队列的异步生成（提交 → 轮询 → 结果）
- 支持 600 多个 AI 模型
- 图像生成：FLUX、SDXL、Recraft 等
- 视频生成：MiniMax、WAN 等
- 语音转文字：Whisper
- 仅依赖标准库，无需 fal_client
使用方式
首先从 https://fal.ai/dashboard/keys 获取 API 密钥，然后进行配置：
export FAL_KEY="your-api-key"
或通过 thinkfleetbot 配置：
thinkfleetbot config set skill.fal_api.key YOUR_API_KEY
交互模式
可以直接在对话中提出需求，例如生成带 FLUX 的赛博朋克城市景观，系统会创建图像并返回 URL。
Python 脚本
可以通过导入 FalAPI 类来调用，例如：
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)
可用模型
资料中列出的模型包括：
- 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
参数
- 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）：用于可复现性的随机种子
适用场景
适合需要批量或按需生成图像、视频，以及进行语音转文字转录的开发者和用户。其仅依赖标准库的特性便于快速集成到已有 Python 环境。
限制
资料未提供关于价格、速率限制、并发上限、错误处理细节、各模型具体生成质量或性能对比、支持的图像尺寸完整列表、视频或音频时长限制等信息，这些方面暂未提供。使用时需要自行获取并配置有效的 fal.ai API 密钥。