Documentation

Everything you need, in five steps

From a fresh install to your first AI render takes about five minutes. This walkthrough covers every control in the panel — what it does and when to reach for it.

01

Set up your workspace

Nano Banana Pro 3 works best in its own workspace, with objects the AI can clearly tell apart. Two buttons handle both.

Button

New WS

Creates a dedicated Nano Banana workspace in Blender — a clean viewport layout with the add-on panel open in the sidebar, ready for capture. Your existing workspaces stay untouched.

Button

Color All

Assigns a distinct flat color to every object in your scene. This is how the AI tells your objects apart — clearly separated colors mean cleaner, more faithful transformations.

Requirement

Gemini API key

The add-on renders through Google's Gemini image AI, so it needs an API key (free tier available) and an internet connection. Paste the key once in the add-on preferences — it's stored locally.

The Nano Banana Pro 3 workspace inside Blender
The dedicated workspace created by “New WS”, panel docked on the right.
Tip Run “Color All” before your first generation. Scenes where every object shares a grey default material give the AI far less to work with.
02

The AI interface

The top half of the panel is where you describe what you want and how much freedom the AI gets.

Model

Fast / Pro

Fast is cheap and quick — perfect for exploring. Pro produces the highest-quality output for final frames.

Prompt

Describe the look

Plain language works: "brushed copper, soft studio light" or "Van Gogh impasto, starry night palette". The prompt combines with whatever preset is active.

Presets

Six style presets

Arch Ext · Arch Int · Packshot · Photoreal · Cinematic · Random — curated starting points for the most common jobs. Random is great for happy accidents.

Slider

Style Influence — Strict ↔ Creative

Strict keeps the AI close to your viewport: same forms, same layout, restyled surfaces. Creative lets it reinterpret the scene more boldly.

Shuffle

Major / Minor

Major shuffles toward a bold new direction. Minor riffs subtly on the current result — use it when you're close and want variations.

Virtual Camera

Lens & aspect ratio

Choose a focal length — 24mm, 50mm, 85mm or 135mm — and an aspect ratio. The AI honors the lens character you pick, from wide-angle drama to portrait compression.

Source Override

Viewport / Camera

Capture exactly what you see in the viewport, or switch to the active scene camera for a precisely framed shot.

Top half of the Nano Banana Pro 3 panel: Setup, AI Settings, Prompt, Styles and Camera
Setup, AI Settings, Prompt, Styles and Camera sections of the panel.
03

Generate — and keep costs tiny

Hit Generate View and the add-on captures your viewport, sends it to Gemini with your prompt and settings, and drops the result into your session history. A simple two-phase habit keeps API costs close to nothing:

While exploring

Fast model + 1K resolution

Iterate freely on style, prompt and shuffle at the lowest cost per image. Most of your generations happen here — make them cheap.

For the final frame

Pro model + 2K or 4K

Once a direction is locked, switch up and generate the keeper at full quality. One expensive render instead of forty.

Workflow Explore on Fast+1K → pick the winner in Session History → re-run it on Pro+4K. Same prompt, same seed of an idea, production-quality result.
04

Render modifiers

The bottom half of the panel holds the modifiers — switches that change what the AI is allowed to touch.

Modifier

Texture Mode

Preserves the materials you authored in Blender. The AI restyles lighting, mood and environment around your objects but never repaints their surfaces — essential when brand colors or fabric textures must survive.

Modifier

Background Blend

Composites your subject into a reference image. Load any photo or render as the target environment and the AI places your objects inside it, matching light direction, color temperature and reflections.

Buttons

Load / Unload background

Load picks the reference image for Background Blend; Unload clears it and returns to prompt-driven environments.

Bottom half of the Nano Banana Pro 3 panel: Render Modifiers, Generate and Session History
Render Modifiers, the Generate button and Session History.
Combine them Texture Mode + Background Blend together is the packshot power move: your exact product, dropped into any location photo, lit to match.
05

Session history

Every render is auto-saved the moment it arrives — nothing is ever lost to an accidental click.

Auto-save

Every generation is kept

Renders are stored automatically in a banana_history/ folder next to your .blend file, so they travel with the project.

Navigate

Browse, reuse, branch

Step back and forth through the session, bring any earlier render back as the current result, and branch from it with Minor Shuffle or a tweaked prompt.

Clean up

Delete the misses

Remove individual renders from the history when an experiment doesn't pan out — keep the folder tidy without leaving Blender.

That's the whole tool

Now go make something weird

Blender 4.0+, a Gemini API key, and an idea. That's the entire requirements list.