用途:该技能是 Higgsfield nano_banana_2 的 FAL.ai 回退方案,使用同一 Nano Banana 模型(Google Gemini 2.5 Flash Image),经 fal 按次计费网关调用。主要供 video-orchestrator/create-clips 的 Phase 0(卡通风格锚点)、Phase 1(卡通逐场景关键帧)、lock-character(广告使用卡通角色时,较少)以及生成回退路由器 generate_with_fallback.py 在 Higgsfield 失败时使用。输入与 Higgsfield 路径一致:提示词加可选参考图,输出 PNG。
主要能力与输出:生成单张图片;输出 <output_path> PNG(须大于 1 KB)以及 <output_path>.meta.json,含请求、结果元数据与成本估算。质量控制包括:文件存在且大于 1 KB、宽高比符合请求、meta.json 包含 gateway: "fal" 与 model: "fal-ai/nano-banana"。
使用方式:需要 FAL_API_KEY 或 FAL_KEY 于 .env。预检:test -n "$FAL_API_KEY" || test -n "$FAL_KEY" || { echo "Missing FAL_API_KEY / FAL_KEY in .env"; exit 1; },以及 python3 -c "import fal_client" || pip3 install fal_client。调用命令:python3 skills/atoms/image-generation/create-image-nano-banana-fal/scripts/generate.py --prompt "..." --output /path/to/scene-NN.png --aspect-ratio 9:16 --resolution 1k [--ref-image /path/to/anchor.png ...]。脚本会加载 FAL 密钥、上传参考图到 fal 存储、调用 fal_client.subscribe("fal-ai/nano-banana", {prompt, image_urls?, aspect_ratio, num_images: 1})、下载首张结果图并写入元数据。可选参数:aspect_ratio(默认 9:16)、resolution(1k 默认或 2k)、ref_image(一个或多个本地参考图)。
限制与注意:提示词不得包含品牌文字(UI 与字标需在后期合成);Nano Banana 会扭曲短品牌文字、URL、代码标记、字幕和字标,应使用 PIL 或 ffmpeg drawtext 叠加可读文字,图片生成仅用于纯视觉内容。失败模式:401 为密钥错误;429 为账户 RPS 限制,可降至 2-3 并发;403 存储/鉴权/令牌通常为余额耗尽,需在 fal.ai/dashboard/billing 充值后重跑。定价(截至 2026-05)为 1k 分辨率每张 $0.039。该技能在 Higgsfield 主路径失败时由回退路由器触发,也可通过 provider_override=fal 直接调用,否则优先 Higgsfield。