FAL Image Gen — FAL 图像生成

FAL 图像生成 通过 fal.ai 和 BytePlus Seedream APIs 生成专业图像。

环境变量 export FAL_API_KEY="你的 fal_api_key" export BYTEPLUS_API_KEY="你的 byteplus_api_key" #用于 Seedream 后端

模型路由 有两个后端可用。代理可以为用户提供模型选择，或者根据任务自动选择。 后端：fal.ai 任务 模型 标志 价格 参考引导（i2i） fal-ai/nano-banana-pro/edit（默认，当提供参考时） $0.15 文本到图像 fal-ai/flux-2-pro（默认，当没有参考时） ~$0.05 海报/信息图（t2i） fal-ai/nano-banana-pro --model nbp $0.15 文本在图像中 fal-ai/ideogram/v3 — — NBP 优势：最佳文本渲染（5/5），JSON 结构化提示，4K 分辨率。

后端：BytePlus Seedream 任务 模型 标志 价格 文本到图像 seedream-4-5-251128 --model seedream $0.03 参考引导（i2i） seedream-4-5-251128 --model seedream --refs ... $0.03 Seedream 优势：5 倍更便宜，支持最多 14 个参考图像，自然色彩渲染和适当的提示。

模型别名 别名 路由到 seedream, byteplus, sd BytePlus Seedream nbp, nano-banana-pro, poster fal.ai NBP t2i flux, flux-2-pro fal.ai Flux

自动选择逻辑 用户指定模型 → 使用该模型 没有指定模型 → BytePlus Seedream（默认 — $0.03，最佳照片质量） "--model nbp" 或 "--model poster" → fal.ai NBP（当文本渲染至关重要时） "--model flux" → fal.ai Flux（快速 t2i 回退） "--model fal" → fal.ai 默认路由（NBP用于参考，Flux用于无参考）

为什么 Seedream 默认：5 倍更便宜（$0.03 vs $0.15），支持最多 14 个参考图像，优秀的照片现实感，适当的宽高比控制（1920x2400用于 4:5 等）。

去饱和（每个模型） 每个后端需要不同的颜色控制： Seedream → 基于灯光或杂志编辑描述 NBP → Kodak Portra 400 类比胶片描述

脚本使用 将生成脚本放在 {baseDir}/skills/fal-image-gen/scripts/generate.py。

单个图像 uv run {baseDir}/skills/fal-image-gen/scripts/generate.py \ --prompt "山寺在黄金时间，低角度，24mm f/8..." \ --aspect-ratio 9:16 \ --output {baseDir}/output/

带参考图像 uv run {baseDir}/skills/fal-image-gen/scripts/generate.py \ --prompt "..." \ --refs "https://img1.jpg" "https://img2.jpg" \ --aspect-ratio 4:5

Seedream（BytePlus）— 文本到图像 uv run {baseDir}/skills/fal-image-gen/scripts/generate.py \ --prompt "带有戏剧性山景的旅行海报..." \ --model seedream \ --output {baseDir}/output/

Seedream（BytePlus）— 带参考图像 uv run {baseDir}/skills/fal-image-gen/scripts/generate.py \ --prompt "使用此海报布局，创建..." \ --model seedream \ --refs "https://example.com/ref1.jpg" "https://example.com/ref2.jpg" \ --output {baseDir}/output/

海报模式 — NBP（JSON 结构化提示） uv run {baseDir}/skills/fal-image-gen/scripts/generate.py \ --prompt '{"meta":{...},"poster_structure":{...},"design_style":{...}}' \ --model nano-banana-pro \ --aspect-ratio 3:4 \ --output {baseDir}/output/

批量并行（从 JSON） uv run {baseDir}/skills/fal-image-gen/scripts/generate.py \ --prompts-json batch.json \ --output {baseDir}/output/

JSON 格式用于批量（自由混合模型）： [ {"prompt": "...", "refs": ["url1", "url2"], "aspect_ratio": "9:16", "label": "scene_a"}, {"prompt": "...", "model": "seedream", "refs": ["url1"], "label": "scene_b"}, {"prompt": "{...json...}", "model": "nano-banana-pro", "label": "poster"} ]

输出 图像保存到 output/YYYY-MM-DD/ 中，具有描述性的文件名 打印 MEDIA: /path/to/image.png 用于网关交付 每个 MEDIA: 行触发网关发送图像

宽高比指南 平台 宽高比 备注 Xiaohongshu / Stories 9:16 垂直全屏 Instagram Feed（2026） 3:4 新的最佳 —— 高于 4:5，更多屏幕空间 Instagram Feed（传统） 4:5 仍然支持，较低 Instagram Carousel 3:4 混合轮播 = 最高参与度（2.33%） Banner / Website 16:9 风景 Square 1:1 通用 / WeChat Moments Poster（默认） 3:4 最适合设计的旅行海报

限制 后端 最大参考速度 成本 BytePlus Seedream 14 ~15-40s $0.03/图像 fal.ai NBP 4 ~15-25s $0.15/图像 fal.ai Flux 0 ~5-10s ~$0.05/图像

批量：并行生成所有图像（异步），可以混合后端 BytePlus URL 在 24 小时后过期 —— 脚本自动上传到 fal.ai 存储以获取永久 URL

分辨率等级（Seedream） 使用 --resolution 标志（或批量 JSON 中的 "resolution" 键）： 等级 像素（4:5） 总数 最适合 标准 1920x2400 ~4.6M 社交媒体，快速生成 高（默认） 2560x3200 ~8M 下载，缩放，高质量 最大 3200x4000 ~12.8M 打印，超高质量

API 限制：最小 3,686,400 像素，最大 16,777,216 像素。

# 标准（快速，社交媒体） uv run generate.py --prompt "..." --resolution standard

# 高（默认） uv run generate.py --prompt "..."

# 最大（打印质量） uv run generate.py --prompt "..." --resolution max