# Nano Banana Pro

> Use when the user asks for Nano Banana Pro or nano banana, or wants Frevana-hosted image generation.

- Skill: `finpeakinc/nano-banana-pro` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add finpeakinc/nano-banana-pro`
- Raw SKILL.md: https://api.skillmd.com/api/skills/finpeakinc/nano-banana-pro/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: finpeakinc (https://skillmd.com/u/finpeakinc)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/finpeakinc/nano-banana-pro

---


# Nano Banana Pro

Generate images through Frevana's AI Factory image API.

This skill returns the validated API response JSON unchanged. Treat `generated_images[0].image_url` as the primary image URL.

## Trigger Phrases

- `Nano Banana Pro`
- `nano banana pro`
- `nano banana`

## What This Skill Needs

- user-provided `prompt` or `contents`
- optional Frevana image config fields: `seed`, `maxOutputTokens`, `responseModalities`, `imageConfig.aspectRatio`, `imageConfig.imageSize`
- `FREVANA_TOKEN` in the environment variables, or an explicit `--token` override for the current run
- `curl`
- `bash`
- `python3`

## Execution Order

1. Confirm the user provided the image prompt.
2. Do not ask for or pass through image routing overrides; the Frevana script owns them.
3. Prefer the script over ad hoc `curl` commands.
4. Let the script read `FREVANA_TOKEN` first.
5. In non-interactive runs, fail fast if the token is missing and tell the user to set `FREVANA_TOKEN` or pass `--token`.
6. Return the raw API response JSON, or the first image URL when the user only wants the hosted asset.
7. Save the JSON with `--output` when useful.

## Allowed Options

- `--seed`
- `--max-output-tokens`
- `--response-modality` (repeatable)
- `--aspect-ratio`
- `--image-size` (`1K`, `2K`, `4K`; numeric values like `1800` and `WxH` values like `1024x1024` are normalized to the nearest tier, using the larger edge for `WxH`; defaults to `1K`)

## Command

```bash
bash <skill-path>/scripts/generate_image.sh \
  --prompt "A polished cinematic illustration of a child exploring a small garden at golden hour" \
  --seed 7 \
  --max-output-tokens 2048 \
  --response-modality IMAGE \
  --response-modality TEXT \
  --aspect-ratio 4:3 \
  --image-size 2K \
  --output ./out/nano-banana-pro-result.json
```

## Response Shape

```json
{
  "generated_images": [
    {
      "image_url": "https://static.frevana.com/images/user-id/example-image-id.png",
      "enhanced_prompt": "string",
      "rai_filtered_reason": "string",
      "mime_type": "image/png"
    }
  ],
  "positive_prompt_safety_attributes": {},
  "credits_consumed": 1
}
```

## Notes

- Do not pass image routing overrides; the script rejects them.
- Do not rewrite, proxy, or transform the returned Frevana image URLs unless the user asks for that.

