SuperAPI AI 工具集

fal-generate

智能体与模型

查看项目

更新于 10-30 16:21

技能介绍

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 查询。资料未提供具体价格、配额、速率限制或平台兼容性信息,这些内容暂未提供。