用途：调用 Frevana 托管的 Gemini 图像端点（后端路由 POST /gemini/image/generate），使用模型 gemini-3-pro-image 生成或编辑图像，适合高保真写实、精细文字与纹理渲染、复杂构图及参考图编辑；快速原型或大批量低延迟场景建议改用 gemini-3.1-flash-image。
主要能力与用法：需要用户提供 prompt 或 contents。可选参考图输入 --image（本地文件）、--image-url（远程 HTTP(S)）、--image-dir（目录递归查找），三者合计最多14张，支持 PNG/JPG/WebP，每张小于50MB。可选图像设置包括 --aspect-ratio（1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9、1:4、4:1、1:8、8:1 等）、--image-size（1K 默认、2K、4K）、--candidate-count/--n（1-8，但带参考图时仅支持1）、--system-instruction、--seed。仅纯文生图时可用采样参数 --temperature（0.0-2.0）、--top-p（0.0-1.0）、--top-k（整数≥1）。认证使用 FREVANA_API_KEY（或 --api-key）／FREVANA_TOKEN（或 --token）；可选归属通过 FREVANA_AGENT_APP_INSTANCE_ID 或 --agent-app-instance-id 传 x-frevana-agent-app-instance-id 头。可选用 --job-id（异步生成与7天去重）与 --output 保存 JSON。
限制：生成与编辑均必须提供 prompt；附参考图时 candidate-count 只能为1，且拒绝 --temperature、--top-p、--top-k；返回的 Frevana 图像 URL 不应改写或代理。环境需 curl、bash、python3。费用、价格与平台细节资料未提供。