用途:调用任意 FAL 图像模型(如 nano-banana edit、gpt-image、flux 等)生成或编辑图片。计费经 fal-proxy 路由到 Ads agent,而非直接调用模型提供方默认地址。
主要能力:支持图像生成与编辑,可用于关键帧、平面封面转换、产品主图编辑等场景。配方(DB 中的 template recipe)负责指定模型与参数,本能力本身是通用的;image_urls 必须是公开 URL,本地产品参考图由 orchestrator 通过 MCP 上传并预签名后托管。若专门使用 OpenAI gpt-image 系列,另有 create-image-gpt-image-fal。
使用方式:命令行运行 gem_image.py --model fal-ai/nano-banana/edit --payload '{...}' --out keyframe.png 其中 --model 指定模型,--payload 传入参数 JSON,--out 指定输出文件;执行后会返回 *.fal.media URL。付费调用经由 bundled media_proxy.py 走 GooseWorks 代理,不应使用提供方 SDK 的默认主机。
限制:image_urls 需为公开可访问地址;模型与提示词由配方提供,调用前需确认配方内容;具体支持模型清单、参数格式细节、配额与价格、错误处理等资料暂未提供。