Product & Lifestyle Concepts
Create product-related scenes from prompts or modify a single product photo for alternate visual treatments.
Nano Banana API. Image generation and editing.
Bring Nano Banana image generation and editing into your product with Topview API. Generate images in five supported aspect ratios, edit a single input image, and use straightforward per-image pricing, without a selectable resolution tier.
Lower than the official rate5 aspect ratiosOne standard output sizeSingle-image editing
TRY Nano Banana API FOR FREE
Settings
Text to Image
Settings here are a preview. Generate copies your prompt and opens the matching Platform Playground, where you confirm the final settings.
MODEL SPECIFICATIONS
Know the settings before you build.
A quick reference for Nano Banana settings listed in Topview API Platform docs. Each mode has its own input requirements.
| Parameter | Value |
|---|---|
| Provider / Model | Google / Nano Banana |
| API route | google/nano-banana |
| Generation modes | Text to Image · Image Editing |
| Resolution | Standard output (no resolution parameter) |
| Aspect ratios | 1:1 · 16:9 · 9:16 · 4:3 · 3:4 |
| Image Editing inputs | 1 image |
| Prompt length | Up to 4,000 characters |
| Task pattern | Async submission + polling + output retrieval |
| Pricing | Per generated image; settlement follows actual usage |
DEVELOPER QUICKSTART
From API key to your first image.
Submit an asynchronous prediction with your Platform API key, then poll the returned task ID to retrieve the output.
# Set TOPVIEW_API_PLATFORM_KEY once. Preserve REQUEST_KEY and input for uncertain retries.
# For a NEW task only, unset REQUEST_KEY first. Save data.id to resume GET only.
: "${TOPVIEW_API_PLATFORM_KEY:?Set TOPVIEW_API_PLATFORM_KEY first}"
export REQUEST_KEY="${REQUEST_KEY:-$(uuidgen)}"
curl --fail-with-body 'https://platform-backend.topview.ai/api/v1/models/google/nano-banana/text-to-image/predictions' \
-H "Authorization: Bearer $TOPVIEW_API_PLATFORM_KEY" \
-H "Idempotency-Key: $REQUEST_KEY" \
-H 'Content-Type: application/json' \
--data '{
"prompt": "A blue ceramic cup on a wooden table",
"aspect_ratio": "1:1"
}'
# Poll data.id until completed or failed.
curl --fail-with-body 'https://platform-backend.topview.ai/api/v1/predictions/REQUEST_ID' \
-H "Authorization: Bearer $TOPVIEW_API_PLATFORM_KEY"Sample matches the Nano Banana text-to-image request in Platform docs. Keep TOPVIEW_API_PLATFORM_KEY on your server only.
Step 1
Get Your API Key
Sign in to Topview API Platform and create an API key with the required model permissions. Keep your key secure and use it to authenticate API requests.
Step 2
Generate or Edit an Image
Submit a text prompt or upload reference images for editing. Configure the supported image settings, send your API request, and save the returned task ID.
Step 3
Retrieve Your Image
Check the task status until generation is complete. Retrieve the image URLs, review the final usage cost, and save your generated images.
BUILT FOR PRODUCTION WORKFLOWS
Add simple image creation and editing to everyday apps
The original Nano Banana API supports common image-generation tasks with one standard output size and a focused set of reference-editing controls.
Social Graphics in Five Ratios
Generate square, landscape, or portrait concepts across the five supported aspect ratios, including 4:3 and 3:4.
Single-Image Creative Edits
Let users restyle a photo, change its surroundings, or explore new composition directions using one editing input.
Starter Image Features
Add basic text-to-image generation and one-image editing to creator tools, internal workflows, or small marketing applications.
WHY TOPVIEW API
A simple entry point for the original Nano Banana API
Topview provides the documented modes and format options for teams that want the original model rather than a newer Nano Banana variant.
A Standard-Size Pricing Model
Review the current per-image rate without adding unsupported 2K or 4K resolution selectors.
Five Supported Aspect Ratios
Test 1:1, 16:9, 9:16, 4:3, and 3:4 before mapping your product’s output settings.
Test One-Image Editing
Explore prompt-based edits with a single source photo using the dedicated editing route and documented input requirements.
Compare the Nano Banana Family
Use one Topview workspace to evaluate the original model against Lite, 2, and 2.1 as your output and editing needs evolve.
Nano Banana API FAQs
You can open the Nano Banana Playground to explore its settings. API usage is paid from your Platform USD balance, and promotional credits vary over time. Check your workspace's current eligibility and balance on Topview API Platform.
Topview API Platform lists Text to Image and Image Editing. Image Editing accepts one input image together with your prompt.
Nano Banana supports 1:1, 16:9, 9:16, 4:3, and 3:4. There is no resolution parameter; each request returns one standard output size.
Nano Banana and Nano Banana 2 Lite both offer simple per-image pricing without a resolution selector. Choose based on supported aspect ratios, edit inputs, and the current rate. For selectable 2K or 4K output, compare Nano Banana 2 and Nano Banana 2.1.
Create a Platform API key, submit a prediction to the Nano Banana endpoint with an Idempotency-Key, save the returned task ID, and poll until it completes. Then download the images promptly, because result URLs can expire. Keep your key server-side.
EXPLORE RELATED APIS
More AI image models, one destination.
YOUR NEXT IMAGE STARTS HERE
Build with Nano Banana API
Try your first prompt in the Playground, compare current pricing, or follow the docs to integrate Nano Banana into your application.