用途：通过 Frevana 的 POST /gemini/image/generate 接口生成或编辑托管图片，脚本固定 provider 为 gemini、模型为 gemini-nano-banana-2.1，不支持路由覆盖；该模型走服务端 Interactions API 路径，旧版 Nano Banana 2 配置字段不适用。
主要能力：需要用户提供图片提示词或编辑指令；支持本地参考图（--image）、远程 HTTP(S) 参考图（--image-url）和目录（--image-dir，递归排序），最多 14 个 PNG/JPEG/WebP 参考，每个小于 50MB。可选 --thinking-level（minimal、medium、high）、--aspect-ratio（1:1、1:4、1:8、2:3、3:2、3:4、4:1、4:3、4:5、5:4、8:1、9:16、16:9、21:9）、--image-size（1K、2K、4K，不支持数字像素）、--system-instruction、--seed、--candidate-count/--n（仅 1）。
使用方式：优先使用 scripts/generate_image.sh。认证用 FREVANA_TOKEN 或一次性 --token，以 Authorization: Bearer 发送，忽略 FREVANA_API_KEY；非交互运行缺少凭据会快速失败，切勿打印凭据。存在 FREVANA_AGENT_APP_INSTANCE_ID 时发送 x-frevana-agent-app-instance-id，也支持 X_FREVANA_AGENT_APP_INSTANCE_ID 和 --agent-app-instance-id。结果返回 data[0].image_url（兼容响应为 generated_images[0].image_url），--output 保存响应 JSON。异步任务需提供 --job-id（客户端 UUID，七天去重），轮询 GET /gemini/image/jobs/{id} 直到 completed、failed 或 unknown，完成输出在 data 下，取 data[0].image_url；失败或未知不要自动重新提交付费生成。
限制：不支持 --temperature、--top-p、--top-k、--max-output-tokens、--response-modality；FREVANA_API_BASE_URL 可覆盖 API 基址（默认 https://ai-factory.frevana.com）。HTTP 错误、空响应、JSON 格式错误或无效图片结果均视为失败，不得声称已生成托管图片。