Mode: Text to Image
Comic Strip
Suggested test configuration: 1:1
Nano Banana 2 API. Sharp images up to 4K.
Bring Nano Banana 2 image generation and editing into your product with Topview API. Create 1K, 2K, or 4K images and edit with one or two input images, with transparent per-image pricing, a ready-to-use Playground, and developer docs.
Lower than the official rate1K · 2K · 4K1:1 · 16:9 · 9:16Edit with up to 2 images
TRY Nano Banana 2 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 API can create
Real Nano Banana 2 outputs with the prompts behind them. Copy a prompt and test it in the Playground.
Mode: Image Editing
Magazine Cover
Suggested test configuration: 1:1
Mode: Text to Image
Illustrated Guide
Suggested test configuration: 1:1
Mode: Image Editing
High-Res Upscale
Suggested test configuration: 1:1
MODEL SPECIFICATIONS
Know the settings before you build.
A quick reference for Nano Banana 2 settings listed in Topview API Platform docs. Each mode has its own input requirements.
| Parameter | Value |
|---|---|
| Provider / Model | Google / Nano Banana 2 |
| API route | google/nano-banana-2 |
| Generation modes | Text to Image · Image Editing |
| Resolution | 1K · 2K · 4K (default 1K) |
| Aspect ratios | 1:1 · 16:9 · 9:16 |
| Image Editing inputs | 1–2 images |
| 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-2/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",
"resolution": "1k"
}'
# 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 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
Turn one or two source images into ready-to-use concepts
Nano Banana 2 gives image-generation products a focused set of sizes and common aspect ratios for practical marketing and editing tasks.
Product Scene Variations
Turn an item photo into alternative backgrounds or lifestyle presentations while working with one or two editing references.
Social Campaign Formats
Create square, widescreen, and vertical image concepts for posts, thumbnails, and ad placements using 1:1, 16:9, or 9:16.
Paired-Reference Compositions
Use two source images to guide a combined visual concept, such as a product placed into a chosen environment.
High-Resolution Marketing Drafts
Choose 1K, 2K, or 4K output for campaign concepts, visual mockups, and asset review workflows.
WHY TOPVIEW API
Straightforward image settings for practical integrations
Topview keeps Nano Banana 2’s supported modes, output sizes, and reference-image limits visible as you test and build.
Compare Three Resolution Tiers
Inspect the current per-image price for 1K, 2K, and 4K before deciding which size is right for each task.
Test One- and Two-Image Edits
Use the Playground and documentation to check how the editing route handles the model’s supported reference-image inputs.
Focus on Common Output Ratios
Implement the three supported formats―square, landscape, and portrait―without exposing unsupported aspect-ratio options.
Compare with Nano Banana 2.1
Evaluate whether your application needs the 2.1 variant’s broader aspect-ratio and reference-image support, using the same Platform account.
Nano Banana 2 API FAQs
You can open the Nano Banana 2 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 or two input images together with your prompt.
Nano Banana 2 outputs 1K, 2K, or 4K images in 1:1, 16:9, or 9:16. Price depends on resolution.
On Topview API Platform, Nano Banana 2.1 supports 14 aspect ratios, up to 14 edit inputs, and longer prompts, and its current per-image rates are lower. Nano Banana 2 supports three aspect ratios and up to two edit inputs. Compare both pricing tables before you choose.
Create a Platform API key, submit a prediction to the Nano Banana 2 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 API
Try your first prompt in the Playground, compare current pricing, or follow the docs to integrate Nano Banana 2 into your application.