fal.ai图像生成

技能简介

该技能通过fal.ai平台提供图像与媒体生成能力，支持文本转图像、图像编辑及视频转换等多种任务。集成Google Gemini 3 Pro、FLUX.1 dev等主流模型，采用队列式请求机制并自动轮询结果。

能做什么

• 根据文本描述生成高质量图像（Gemini 3 Pro）
• 对现有图像进行风格迁移与内容编辑
• 将视频转换为具有AI效果的创意视频（Kling O3 Pro）
• 自动管理异步任务队列与状态查询

使用说明

安装配置：

1. 获取API密钥：访问 https://fal.ai/dashboard/keys 注册并创建密钥
2. 配置密钥（二选一）：
   • 环境变量：export FAL_KEY=your-key-here
   • TOOLS.md文件：添加 FAL_KEY: your-key-here

基本用法：

# 验证密钥
python3 scripts/fal_client.py check-key

# 提交文生图任务
python3 scripts/fal_client.py submit "fal-ai/nano-banana-pro" '{"prompt": "山间日落"}'

# 查询任务状态
python3 scripts/fal_client.py status "fal-ai/nano-banana-pro" "<request_id>"

# 获取生成结果
python3 scripts/fal_client.py result "fal-ai/nano-banana-pro" "<request_id>"

# 轮询所有待处理任务
python3 scripts/fal_client.py poll

本地文件处理：

# 图片转base64数据URI
python3 scripts/fal_client.py to-data-uri /path/to/image.jpg

# 视频转base64数据URI（含格式验证）
python3 scripts/fal_client.py to-data-uri /path/to/video.mp4

输入与输出

见下方输入与输出表格。

风险提示

• 视频任务限制严格：仅支持.mp4/.mov格式，时长3-10秒，分辨率720-2160px，单文件不超过200MB
• 元素引用总数上限为4个（包含视频+参考图片+注入元素）
• 部分模型响应较慢（如Gemini图像编辑约20秒），需合理设置超时
• safety_tolerance参数控制内容过滤强度，值越高限制越宽松
• API密钥需妥善保管，避免硬编码在公开仓库中

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/sxela/falai/SKILL.md
来源类型：GitHub仓库