Do this first

• Use a Node.js wrapper (@google/genai ) as the primary flow (multi-turn edits, grounding, advanced generationConfig ).

• Use scripts\nanobanana-cli.js for quick single-turn generation/editing runs.

• Do not teach raw curl ; keep guidance in JS CLI/wrapper form.

Enforce these defaults

• API key source: NANOBANANA_GEMINI_API_KEY with fallback GEMINI_API_KEY .

• Default model: gemini-3.1-flash-image-preview (allow env override via NANOBANANA_MODEL ).

• Reference images: support up to 14 total.

• Thinking strength: configurable (minimal|low|medium|high ), default High.

• Aspect ratio: default Auto.

• Resolution: default 1K.

• Output mode: default Images only.

• Google Search grounding tool: default Disabled; enable with --google-search when needed.

• Output directory: default nanobanana-output/ , unless the prompt explicitly asks for another location.

• 512px rule: send imageConfig.imageSize as string "512" in API calls (never numeric 512 ).

Read references intentionally

• Start in references\image-generation-api.md for operational payload rules, model behavior, sizing, thinking, grounding, and limits.

• Use references\sources.md to verify source provenance and jump to upstream docs.

• For canonical API behavior, read:

• Gemini image-generation docs

• Aspect ratios and image size

• Thinking process

• Grounding with Google Search

• Grounding with Google Image Search

Execution pattern

• Default to Node.js wrapper flows for regular usage, especially when payload control is needed.

• Quick path:

• node scripts\nanobanana-cli.js --prompt "..."

• Add references via repeated -i/--image (up to 14).

• Enable grounding via --google-search when prompt needs fresh web context.