Mode: Text to Image
Product Shots
Place one product in several settings for ads, listings, and social posts.
Nano Banana 2.1 API. 4K images, per-image pricing.
Bring Nano Banana 2.1 image generation and editing into your product with Topview API. Create 1K, 2K, or 4K images in 14 aspect ratios and edit with up to 14 input images, with transparent per-image pricing, a ready-to-use Playground, and developer docs.
Lower than the official rate1K · 2K · 4K14 aspect ratiosEdit with up to 14 images
TRY Nano Banana 2.1 API FOR FREE
Settings
Text to Image · 1k
Settings here are a preview. Generate copies your prompt and opens the matching Platform Playground, where you confirm the final settings.
EXAMPLES & PROMPTS
See what Nano Banana 2.1 API can create
Real Nano Banana 2.1 outputs with the prompts behind them. Copy a prompt and test it in the Playground.
Mode: Text to Image
Posters and Infographics
Generate posters and infographics with cleaner headlines and labels for campaign layouts.
Mode: Text to Image
Character Series
Keep the same character across a comic, campaign, or storyboard sequence.
Mode: Text to Image
Video Thumbnails
Use your own video as reference to make thumbnails and cover images that match the content.
MODEL SPECIFICATIONS
Know the settings before you build.
A quick reference for Nano Banana 2.1 settings listed in Topview API Platform docs. Each mode has its own input requirements.
| Parameter | Value |
|---|---|
| Provider / Model | Google / Nano Banana 2.1 |
| API route | google/nano-banana-2.1 |
| Generation modes | Text to Image · Image Editing |
| Resolution | 1K · 2K · 4K (default 1K) |
| Aspect ratios | 1:1 · 3:2 · 2:3 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9 · 1:4 · 4:1 · 1:8 · 8:1 |
| Image Editing inputs | 1–14 images |
| Prompt length | Up to 10,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-2.1/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",
"resolution": "1k",
"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 2.1 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
Create flexible, reference-heavy image workflows
Nano Banana 2.1 supports high-resolution assets, unusual aspect ratios, and multi-image editing for creative systems that need more than a single source photo.
Multi-Image Product Composites
Combine multiple product, setting, and styling images in an editing request to develop richer ecommerce visuals and campaign compositions.
Campaign Assets Across Formats
Create square, vertical, landscape, and extra-wide imagery using 14 available aspect ratios, including banner-friendly formats.
4K Brand & Editorial Visuals
Generate or edit 1K, 2K, or 4K images for high-detail creative concepts, marketing layouts, and visual content production.
Reference-Based Design Workflows
Build image-editing tools that accept up to 14 source images for guided compositions, visual updates, and creative exploration.
WHY TOPVIEW API
More reference inputs and output sizes in one API
Use Topview to explore Nano Banana 2.1’s broader image-input and format options before implementing them in your product.
Try Up to 14 Editing Inputs
Test real source-image combinations in the Playground, then follow the Image Editing schema when you integrate.
Price by Output Resolution
Compare per-image rates for 1K, 2K, and 4K rather than assuming one image price fits every configuration.
Preview Unusual Aspect Ratios
Validate the full set of 14 available ratios for wide banners, social placements, and specialized creative formats.
Use One Workspace for Image Models
Compare Nano Banana 2.1 with Nano Banana 2 and other image APIs without setting up separate provider accounts.
Nano Banana 2.1 API FAQs
You can open the Nano Banana 2.1 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 1–14 input images together with your prompt.
Nano Banana 2.1 outputs 1K, 2K, or 4K images and supports 14 aspect ratios, from 1:1 and 16:9 to extreme formats such as 1:8 and 8:1. Price depends on resolution.
Each generated image is billed at the rate for its resolution, and Text to Image and Image Editing currently share the same rates. Submitting reserves funds, and read charged_usd on the completed task for the final cost.
Create a Platform API key, submit a prediction to the Nano Banana 2.1 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 2.1 API
Try your first prompt in the Playground, compare current pricing, or follow the docs to integrate Nano Banana 2.1 into your application.