SuperAPI AI 工具集

fal-ai-image

设计与创作

查看项目

更新于 10-15 19:57

技能介绍

用途:通过 fal.ai 生成或编辑图像,支持两种 fal 托管模型:Google Nano Banana Pro(fal-ai/nano-banana-pro,默认)与 OpenAI GPT Image 2(openai/gpt-image-2,需在 config/.env 启用)。适合信息图、文字渲染、横幅、照片编辑和基于参考图的合成。

主要能力:提供生成模式与编辑模式。有参考图时用编辑模式(先 upload.sh 再 edit.sh),纯文本生成用生成模式(generate.sh)。模型选择来自 config/.env:未设置选择器时用 Nano Banana Pro,FAL_IMAGE_PROVIDER=openai 时用 GPT Image 2,FAL_IMAGE_MODEL 可精确覆盖;也可用 --model 单次覆盖,别名 gpt/openai 对应 GPT Image 2,nano-banana/google/gemini 对应 Nano Banana Pro。Nano Banana 支持 --aspect-ratio、--resolution、--web-search(仅生成);GPT Image 2 支持 --image-size、--quality,若省略 --image-size 会由宽高比与分辨率推导。

使用方式:需在 config/.env 或环境变量中提供 FAL_KEY。生成示例:sh scripts/generate.sh --model "gemini" --prompt "infographic about coffee brewing" --aspect-ratio "9:16" --resolution "1K" --output-dir "./images" --filename "coffee_infographic"。编辑示例:sh scripts/edit.sh --model "gpt" --prompt "make this product shot look like a premium studio campaign" --image-urls "https://example.com/source.png" --mask-url "https://example.com/mask.png" --image-size "auto" --quality "medium" --output-dir "./images" --filename "studio_edit"。本地文件先上传:URL=$(sh scripts/upload.sh --file /path/to/image.png)。

限制:不要用 Pillow、ImageMagick 等做文字或 logo 叠加,除非用户明确要求;有参考图时不要用生成模式;不要假设 GPT 已启用;不要猜测各提供商的参数结构。结果 URL 约一小时后过期,fal 存储的上传文件为临时文件。GPT 默认质量为 medium 以控制成本,具体价格以 fal 模型页为准。完整配置与排错见 config/README.md。