Skip to main content
GoogleFastUltra

Nano Banana 2.1

Google's latest fast image generation model — the high-efficiency counterpart to Nano Banana Pro. Builds on Nano Banana 2 with sharper output, better text rendering, and real-time grounding while keeping Flash-family speed and cost. Features conversational editing, multi-image fusion with up to 14 reference images, Google Web / Image Search grounding, and resolutions up to 4K.

79 credits
per image (1K), 120 for 2K, 260 for 4K
Sharper output and better text rendering than Nano Banana 2
Accurate multilingual text in signage, posters, labels, and infographics
Google Web Search and Image Search grounding for real-time context
Up to 14 reference images for editing and multi-image fusion
Up to 4K output resolution (1K, 2K, 4K)
Extreme aspect ratios: 1:4, 4:1, 1:8, 8:1

Run it right now

Test this model instantly in the Console Playground — no code required

Sign in to try

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "google/nano-banana-2.1",
  "input": {
    "prompt": "A vibrant storefront window display for a bakery called \"CORE.TODAY\", with the name spelled out in elegant hand-painted gold lettering on the glass, fresh pastries and banana bread artfully arranged inside, warm morning light, photorealistic, highly detailed",
    "aspect_ratio": "16:9",
    "resolution": "1K",
    "output_format": "jpg"
  }
}'

Parameters

ParameterTypeRequiredDefaultDescription
promptstringYes-A text description of the image you want to generate
image_inputarrayNo[]Input images to transform or use as reference (supports up to 14 images)
aspect_ratiostringNomatch_input_imageAspect ratio of the generated image
match_input_image1:11:41:82:33:23:44:14:34:55:48:19:1616:921:9
resolutionstringNo1KResolution of the generated image. Higher resolutions take longer to generate.
1K2K4K
google_searchbooleanNofalseUse Google Web Search grounding for real-time information (weather, sports scores, recent events)
image_searchbooleanNofalseUse Google Image Search grounding for visual context. Enabling this also enables web search.
output_formatstringNojpgFormat of the output image
jpgpng

How to Provide File Input

There are 3 ways to provide files for the image_input parameter:

Recommended

Image URL

Pass a publicly accessible URL directly. With the Storage API (POST /v1/files/upload-url) the file uploads straight to S3 (50MB per file) and you pass the returned file_url.

{
  "model": "google/nano-banana-2.1",
  "input": {
    "prompt": "your prompt here",
    "image_input": ["https://example.com/image.jpg"]
  }
}

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step, but the bytes pass through the API server so the whole request is capped at 10MB.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=google/nano-banana-2.1" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:image_input=@your_file.png"
See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

ParameterTypeRequiredDefaultDescription
modelstringYes-Model identifier
inputobjectYes-Object containing the model-specific parameters from the table above
output_folderstringNo-Folder path for output files (max 256 chars, '..' not allowed)
webhook_urlstringNo-Webhook URL to call on completion
is_publicbooleanNofalseIf true, output files are also available via permanent public URLs

Examples

Text Rendering in a Scene

Render a brand name as hand-painted lettering on a storefront window

Text Rendering in a Scene
curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "google/nano-banana-2.1",
  "input": {
    "prompt": "A vibrant storefront window display for a bakery called \"CORE.TODAY\", with the name spelled out in elegant hand-painted gold lettering on the glass, fresh pastries and banana bread artfully arranged inside, warm morning light, photorealistic, highly detailed",
    "aspect_ratio": "16:9",
    "resolution": "1K",
    "output_format": "jpg"
  }
}'

Photorealistic Close-up

Generate a playful photorealistic image with golden hour lighting

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "google/nano-banana-2.1",
  "input": {
    "prompt": "a photorealistic close-up of a ripe banana wearing tiny sunglasses on a beach, golden hour lighting",
    "aspect_ratio": "16:9",
    "resolution": "1K"
  }
}'

Tips & Best Practices

1Cheapest way to get Nano Banana quality — 1K costs 79 credits, less than half of Nano Banana 2
2Text rendering is sharper than Nano Banana 2 — put exact wording in quotes for signage, posters, and labels
3Use google_search for real-time data (weather, sports, news); image_search adds web images as visual context
4Use 1K (79 credits) for drafts and 4K (260 credits) only for final production assets
5Set aspect_ratio to match_input_image when editing to keep the original framing
6Combine up to 14 reference images with a text prompt for style fusion and character consistency

Use Cases

Typography, logos, and branding with accurate multilingual text
Infographics and posters that need clean, readable text
Real-time data visualization using Google Search grounding
Conversational image editing with reference images
High-resolution content production up to 4K at Flash-level cost

Model Info

ProviderGoogle
Version-
CategoryImage Generation
Price79 credits

API Endpoint

POST /v1/predictions
Try in ConsoleBack to Docs