Nano Banana 2.1

Generate or edit hosted images through POST /gemini/image/generate. The script fixes provider gemini and model gemini-nano-banana-2.1; do not pass routing overrides. This model uses the server's Interactions API path, so the older Nano Banana 2 config fields do not apply.

Workflow

1. Require a user-provided image prompt or editing instruction. Prefer scripts/generate_image.sh over ad hoc API requests.
2. Map local references to repeatable --image, remote HTTP(S) references to --image-url, and directories to --image-dir. Up to 14 PNG/JPEG/WebP references are supported in total, each under 50MB.
3. Use FREVANA_TOKEN, or a one-time --token override. Send it as Authorization: Bearer; ignore FREVANA_API_KEY. Missing credentials fail fast in non-interactive runs. Never print credentials.
4. The script sends x-frevana-agent-app-instance-id when FREVANA_AGENT_APP_INSTANCE_ID is present. It also supports X_FREVANA_AGENT_APP_INSTANCE_ID and the explicit --agent-app-instance-id override.
5. Return a concise result and the primary hosted URL at data[0].image_url (or generated_images[0].image_url for compatible responses). Preserve API fields and URLs; return full JSON when requested. --output saves the validated response JSON locally.
6. If --job-id is supplied, the response acknowledges an asynchronous job; it does not confirm successful generation. Follow the async instructions below before claiming completion.

Options