Nana Banana Pro
Google's Gemini 3 Pro Image via Google Cloud with 4K support
Nana Banana Pro
Google's Gemini 3 Pro Image model accessed directly through Google Cloud Vertex AI. This provides the highest resolution output (up to 4K) and the imageSize parameter.
| Property | Value |
|---|---|
| Model ID | google/nana-banana-pro |
| Provider | Google Cloud |
| Type | Image generation |
| Max Size | 4K (4096px) |
This is the same underlying model as Nano Banana
Pro, but accessed directly through Google Cloud
instead of Replicate or Fal. The direct access enables the imageSize
parameter for 4K generation.
Setup
Before using this model, configure your Google Cloud credentials. See the Google Cloud Provider guide for setup instructions.
Basic Usage
import { compose, generateImage, imageModel } from "@synthome/sdk";
const execution = await compose(
generateImage({
model: imageModel("google/nana-banana-pro", "google-cloud"),
prompt: "A professional corporate thumbnail with bold typography",
aspectRatio: "16:9",
}),
).execute();4K Image Generation
The key advantage of using Google Cloud directly is the imageSize parameter:
generateImage({
model: imageModel("google/nana-banana-pro", "google-cloud"),
prompt: "Detailed product photography for print catalog",
imageSize: "4K", // 4096px resolution
});Available Sizes
| Size | Resolution | Best For |
|---|---|---|
1K | 1024px | Thumbnails, fast generation |
2K | 2048px | Web, social media |
4K | 4096px | Print, detailed work |
Options
| Option | Type | Default | Description |
|---|---|---|---|
prompt | string | required | Text description |
image | string | string[] | - | Input image(s) |
aspectRatio | string | 1:1 | Output aspect ratio |
imageSize | "1K" | "2K" | "4K" | - | Output resolution |
seed | number | - | Random seed for reproducibility |
Aspect Ratios
Supported aspect ratios:
1:1- Square (default)3:4- Portrait4:3- Landscape9:16- Vertical/Stories16:9- Widescreen
generateImage({
model: imageModel("google/nana-banana-pro", "google-cloud"),
prompt: "Instagram story design with 'SWIPE UP' call to action",
aspectRatio: "9:16",
imageSize: "2K",
});Examples
Marketing Banner
generateImage({
model: imageModel("google/nana-banana-pro", "google-cloud"),
prompt:
"Professional LinkedIn banner with text 'HIRING NOW' in corporate blue",
aspectRatio: "16:9",
imageSize: "4K",
});Product Photography
generateImage({
model: imageModel("google/nana-banana-pro", "google-cloud"),
prompt:
"Minimalist product shot of a coffee mug on marble surface, soft lighting",
aspectRatio: "1:1",
imageSize: "4K",
});Video Thumbnail
generateImage({
model: imageModel("google/nana-banana-pro", "google-cloud"),
prompt:
"YouTube thumbnail with shocked face expression and text 'YOU WON'T BELIEVE THIS'",
aspectRatio: "16:9",
imageSize: "2K",
});Print Material
generateImage({
model: imageModel("google/nana-banana-pro", "google-cloud"),
prompt:
"Restaurant menu design with elegant script typography, 'CHEF'S SPECIAL' header",
aspectRatio: "3:4",
imageSize: "4K", // High resolution for print
});Comparison with Replicate/Fal
| Feature | Replicate/Fal | Google Cloud |
|---|---|---|
| Model ID | google/nano-banana-pro | google/nana-banana-pro |
| Max Resolution | Provider default | 4K (4096px) |
imageSize | Not available | 1K, 2K, 4K |
| Auth | API Key | Service Account JSON |
| Billing | Provider-specific | Google Cloud |
| Best For | Quick integration | Maximum quality |
When to Use Google Cloud
Choose the Google Cloud version when:
- You need 4K resolution for print or detailed work
- You want direct control over image size
- You already have Google Cloud infrastructure
- You need the absolute highest quality output
For faster integration or if you don't need 4K, use Nano Banana Pro via Replicate or Fal.
How is this guide?