名称: fal-api
描述: 通过 fal.ai API 生成图像、视频和音频(支持 FLUX、SDXL、Whisper 等模型)
版本: 0.1.0
元数据:
{
"openclaw": { "requires": { "env": ["FAL_KEY"] }, "primaryEnv": "FAL_KEY" },
}
使用 fal.ai 的 API 生成图像、视频和文字转录,支持 FLUX、Stable Diffusion、Whisper 等多种模型。
fal_client通过以下任一方式配置密钥:
环境变量方式:
bash
export FAL_KEY="your-api-key"
或通过 clawdbot 配置:
bash
clawdbot config set skill.fal_api.key YOUR_API_KEY
你: 用 FLUX 生成一张赛博朋克城市景观
Klawf: 创建图像并返回 URL
from fal_api import FalAPI
api = FalAPI()
# 生成并等待结果
urls = api.generate_and_wait(
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 |
音频转文字 |
要查看完整模型列表,请运行:
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 | 随机种子,用于结果复现 |
本技能基于 krea-api 技能的模式构建,使用 fal.ai 基于队列的 API 实现可靠的异步生成。