fal-generate 是一个面向 AI 内容生成的命令行技能包,通过 fal.ai 的模型接口完成生成任务。其核心特点是基于队列系统:提交请求后可等待完成,也可先获取请求 ID,稍后再轮询结果。
主要能力
技能覆盖多种内容类型,包括文本生成图片、图片编辑与转换、文本生成视频、图片生成视频、文本转语音、语音转文本、文本生成 3D 模型、图片生成 3D 模型,以及通过 OpenRouter 运行任意大语言模型、视觉模型、音频模型和视频模型。资料中列出的模型示例包括 Kling V3、FLUX.2、Grok Imagine、Veo 3.1、MiniMax、Hunyuan 3D、OpenRouter 等,并给出了大量具体端点及用途说明。
脚本与使用方式
资料提供四个脚本:scripts/generate.sh 为主生成工具,负责队列管理;scripts/upload.sh 将本地文件上传到 fal CDN 并返回 URL;scripts/poll.sh 轮询队列状态直至完成;scripts/models.sh 用于搜索和发现模型。使用前需设置环境变量 FAL_KEY。生成脚本在带 --wait 参数时,会向标准输出返回 JSON,其中包含生成内容的 URL;不带 --wait 时输出请求 ID;使用 --async 时仅返回请求 ID 供后续轮询。
输出格式
图片输出为包含 url、width、height 的 images 数组;视频输出为 video.url;音频输出为 audio.url 或 audio_url;3D 模型输出为 model_mesh.url,格式为 glb;转写输出为 text 字段;OpenRouter 输出为 output 字段中的文本回复。
常用参数
脚本支持 -m/--model 指定模型端点,-p/--prompt 指定文本描述,-t/--text 用于 TTS 文本,--image-url、--video-url、--audio-url 传入输入文件 URL,--aspect-ratio 设置画面比例,--duration 设置视频时长,--seed 复现结果,--wait 等待完成,--async 仅返回 ID,--param 传递模型专属参数。
适用场景
适合需要通过命令行批量或脚本化调用多模态生成模型的开发者,例如生成图片素材、编辑图片、制作短视频、合成语音、克隆音色、转写录音、生成 3D 模型,以及用统一入口调用多种大语言模型和视觉模型。
限制与注意事项
资料明确要求必须配置 FAL_KEY;部分能力依赖上传本地文件后取得 URL。建议使用 --wait 或 --async,否则只会得到请求 ID 和手动 curl 命令。模型专属参数可通过 models.sh --schema 查询。资料未提供具体价格、配额、速率限制或平台兼容性信息,这些内容暂未提供。