| name | whisk-proxy |
| description | Generate images with Google Imagen 4 and Nano Banana for free via Flow API. No API key, no paid subscription — just a Google account and Chrome extension. Use when the user asks to generate, create, or make an image, picture, illustration, logo, banner, or avatar. Triggers: generate image, create picture, make illustration, нарисуй, сгенерируй картинку, создай изображение. Do NOT use for image editing, upscaling, background removal, video generation, or non-Google AI models (DALL-E, Midjourney, Stable Diffusion).
|
Flow Image Generator
Generate images using Google Imagen 4, Nano Banana, and Reference-to-Image for free. No API key — uses Chrome extension for OAuth.
Quick Start
node {baseDir}/scripts/generate.mjs -p "a cat astronaut floating in space"
node {baseDir}/scripts/generate.mjs -p "abstract painting in neon colors" -m banana
node {baseDir}/scripts/generate.mjs -p "watercolor portrait" -m r2i
node {baseDir}/scripts/generate.mjs -p "anime girl with headphones" -r 9:16 -c 1
node {baseDir}/scripts/generate.mjs -p "sunset over mountains" -o ./images
Models
| Model | Flag | Best for |
|---|
| Imagen 4 | -m imagen4 (default) | Highest quality, photorealistic |
| Nano Banana | -m banana | Fast, creative generation |
| Reference-to-Image | -m r2i | Style transfer |
Options
| Flag | Short | Default | Description |
|---|
--prompt | -p | required | Image description (English works best) |
--model | -m | imagen4 | Model: imagen4, banana, r2i |
--count | -c | 4 | Number of images (1-4) |
--ratio | -r | 1:1 | Aspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4 |
--output | -o | . | Output directory |
--seed | -s | random | Seed for reproducibility |
Aspect Ratios
1:1 (1024x1024) — avatars, icons, social posts16:9 (1365x768) — banners, covers, YouTube thumbnails9:16 (768x1365) — stories, reels, vertical posters4:3 — classic landscape3:4 — classic portrait
Authentication
Token stored in ~/.flow-proxy/token.json. The Chrome extension handles auth automatically.
Check token status
node {baseDir}/scripts/status.mjs
First-time setup
- Install the Chrome extension from
{baseDir}/extension/ (load unpacked)
- Open https://labs.google/fx/tools/flow
- Sign in with Google
- Click the Flow Proxy extension icon → "Connect"
Token auto-refreshes via session cookie (~30 days). After that, repeat step 4.
If token is expired
The CLI script auto-detects expired tokens and starts a local auth server.
Just click "Connect" in the Chrome extension — no manual token copying needed.
The agent should check status.mjs first. If token is expired, run generate.mjs — it will start the auth server and wait for the extension. Tell the user to click "Connect" in the extension.
Important
- Prompts in English produce best results
- The API is free but rate-limited (Google account level)
- Images saved as PNG
- Do NOT read generated PNG files into context — they consume thousands of tokens
