GoogleFastStandard

Nano Banana 2 Lite

Google's lightweight Nano Banana 2 variant built on Gemini 3.1 Flash Image, tuned for faster and cheaper generation. Retains conversational editing, multi-image fusion, and character consistency from the full Nano Banana 2.

80 credits

per image (fixed price)

Faster, lower-cost variant of the full Nano Banana 2 model

Built on Gemini 3.1 Flash Image

Conversational, instruction-based editing

Multi-image fusion from up to 14 reference images

Character consistency preserved across generations

Wide range of aspect ratio presets including auto-match to input image

Run it right now

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

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

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-lite",
  "input": {
    "prompt": "Change the background to a warm sunset gradient and add soft rim lighting on the product",
    "image_input": [
      "https://example.com/product-photo.jpg"
    ],
    "aspect_ratio": "1:1"
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`prompt`	string	Yes	-	A text description of the image you want to generate
`image_input`	array	No	[]	Input images to transform or use as reference (supports up to 14 images)
`aspect_ratio`	string	No	match_input_image	Aspect ratio of the generated image match_input_image1:11:41:82:33:23:44:14:34:55:48:19:1616:921:9
`output_format`	string	No	jpg	Format of the output image jpgpng

How to Provide File Input

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

Recommended

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step needed.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=google/nano-banana-2-lite" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:image_input=@your_file.png"

Image URL

Pass a publicly accessible URL directly. You can also use file_url from the Storage API.

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

See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Fast Iterative Edit

Quick conversational edit on an existing product photo

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-lite",
  "input": {
    "prompt": "Change the background to a warm sunset gradient and add soft rim lighting on the product",
    "image_input": [
      "https://example.com/product-photo.jpg"
    ],
    "aspect_ratio": "1:1"
  }
}'

Multi-Image Fusion

Fuse two reference photos into a single composed 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-lite",
  "input": {
    "prompt": "Place the person from the first photo into the café scene from the second photo, matching the lighting and perspective",
    "image_input": [
      "https://example.com/person.jpg",
      "https://example.com/cafe.jpg"
    ],
    "aspect_ratio": "3:4",
    "output_format": "png"
  }
}'