用途：该技能通过 Frevana 的 Gemini 图像接口调用 gemini-3.1-flash-image，用于文生图或基于参考图的图像编辑，适合快速迭代、社交与创作者内容、原型、产品工作流及高批量生成；若追求最大细节、复杂多物体构图或高保真写实，资料建议改用 gemini-3-pro-image。
主要能力与所需输入：需用户提供的提示词（prompt，生成与编辑均必需）。可选参考图输入为 --image、--image-url、--image-dir，最多 14 张参考图，支持 PNG/JPG/WebP，单张小于 50MB。可选图像设置：--aspect-ratio、--image-size、--candidate-count、--system-instruction、--seed。仅文生图可用采样设置 --temperature、--top-p、--top-k。异步与去重可用 --job-id。认证使用 FREVANA_API_KEY（或 --api-key）/ FREVANA_TOKEN（或 --token）；可选归属参数 FREVANA_AGENT_APP_INSTANCE_ID（或 X_FREVANA_AGENT_APP_INSTANCE_ID，或 --agent-app-instance-id），以 x-frevana-agent-app-instance-id 头发送。依赖 curl、bash、python3。
使用方式：确认提示词；本地参考图映射为可重复的 --image，远程 URL 映射为 --image-url，目录映射为 --image-dir。编辑规则：存在参考图时 candidate_count 仅支持 1；无参考图时才允许文生图采样参数。脚本从环境读取密钥，或由 CLI 覆盖。后端路由为 POST /gemini/image/generate。
返回与限制：返回校验后的 API 响应 JSON，主图 URL 取 generated_images[0].image_url（或 data[0].image_url）。可用 --output 保存 JSON。不要在未要求时重写或代理返回的 Frevana 图片 URL。
命令示例：
bash <skill-path>/scripts/generate_image.sh
--prompt "A vibrant futuristic city with neon lights and flying vehicles at dusk"
--aspect-ratio 16:9
--image-size 2K
--candidate-count 1
--temperature 1.0
--output ./out/gemini-flash-result.json
编辑示例：
bash <skill-path>/scripts/generate_image.sh
--prompt "Change the background to a sunny beach while keeping the product style intact"
--image ./refs/product.png
--aspect-ratio 1:1
--image-size 1K
--candidate-count 1
--output ./out/gemini-flash-edit-result.json
可选值：--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，默认 1K；--candidate-count/--n 为 1-8（编辑仅 1）；--temperature 0.0-2.0；--top-p 0.0-1.0；--top-k 整数且不小于 1；--seed 为可复现随机种子；--job-id 为客户端 UUID，用于异步与 7 天去重。