google/nano-banana-2.1/text-to-image

Text to Image

Google Nano Banana 2.1 is the newest Nano Banana Flash model, with better visual design and more natural-looking images than earlier versions. Strong for posters, ads and packaging with readable text, offering 1K to 4K output, three thinking levels, optional web search and 14 aspect ratios plus auto.

Try it Get API keyOpenAPI llms.txt

Prompt *

347 / 50,000

Aspect Ratio

Resolution

More settings (6)

Enable Web Search

Number of Images

Output Format

Seed

System Prompt

0 / 50,000

Thinking Level

ResultExampleSign in to try

Billed per token · about $0.04 per image at default settings · $0.03968 reserved per request

Example — generated from this input

A minimalist product poster for a new iced oolong milk tea: the cup sits on a warm beige background with a few scattered tea leaves and fine condensation on the glass. A thin serif headline reads "MOUNTAIN OOLONG" at the top, with a small caption "New arrival · Autumn edition" at the bottom. Soft natural side light, clean commercial photography.

Pricing

Text input /M: $1.764
Image input /M: $1.764
Text output /M: $8.823
Image output /M: $35.294

About $0.04 per image at default settings (1K, 1 image); higher quality, larger sizes and more images use more tokens.

Each request temporarily reserves $0.03968; you are charged for actual usage, usually within a minute: any unused amount is released and any usage above it is charged to your balance, even if that takes it below zero; while your balance is below zero, new requests are paused until a top-up covers it.

Failed generations are not charged.

API

Submit generation requests with this model ID.

POST/v1/model-tasks

google/nano-banana-2.1/text-to-image

Request body

{
  "model": "google/nano-banana-2.1/text-to-image",
  "input": {
    "prompt": "A minimalist product poster for a new iced oolong milk tea: the cup sits on a warm beige background with a few scattered tea leaves and fine condensation on the glass. A thin serif headline reads \"MOUNTAIN OOLONG\" at the top, with a small caption \"New arrival · Autumn edition\" at the bottom. Soft natural side light, clean commercial photography.",
    "aspect_ratio": "auto",
    "enable_web_search": false,
    "num_images": 1,
    "output_format": "png",
    "resolution": "1K",
    "system_prompt": "",
    "thinking_level": "medium"
  }
}

Input schema

Parameter	Type	Requirement	Default
prompt	string	Required	—
aspect_ratio	string	Optional	auto
enable_web_search	boolean	Optional	false
num_images	integer	Optional	1
output_format	string	Optional	png
resolution	string	Optional	1K
seed	integer	Optional	—
system_prompt	string	Optional
thinking_level	string	Optional	medium

Response

The API returns a result or a pollable asynchronous task. See the examples and Schema below for the response mode and result fields.

Asynchronous task

Submit response

HTTP 202

/v1/model-tasksapplication/json

{
  "id": "task_example",
  "model": "google/nano-banana-2.1/text-to-image",
  "status": "queued"
}

Status response

HTTP 200

/v1/model-tasks/{id}application/json

{
  "id": "task_example",
  "model": "google/nano-banana-2.1/text-to-image",
  "status": "completed",
  "output": {
    "images": [
      {
        "url": "https://api.musespan.com/v1/model-tasks/task_example/artifacts/0"
      }
    ]
  }
}

File download

HTTP 200

/v1/model-tasks/{id}/artifacts/{index}Generated image (e.g. image/png)

When the task completes, file URLs in output point to this endpoint, numbered from 0. Send the same API key (Authorization header) when downloading.

Error response

HTTP 400

/v1/model-tasksapplication/json

{
  "error": {
    "code": "invalid_input",
    "message": "The input does not match this model's input schema. Check the model's API documentation.",
    "type": "invalid_request_error"
  }
}

Code examples

Async submission returns a task ID. Poll until status is completed, then retrieve the generated content from the result. Get your API key in the console.

# Use a new directory for each new generation. Rerunning here continues this task.
set -eu
test -s model-task-id.txt || python3 -c "import uuid; print(uuid.uuid4())" > model-task-id.txt
REQUEST_ID=$(cat model-task-id.txt)
# Idempotent: resending the same bytes with the same ID never charges twice.
curl --fail-with-body --retry 3 --retry-connrefused --request POST 'https://api.musespan.com/v1/model-tasks' \
  --header "Authorization: Bearer $MUSESPAN_API_KEY" \
  --header "X-Request-Id: $REQUEST_ID" \
  --header "Content-Type: application/json" \
  --data '{"model":"google/nano-banana-2.1/text-to-image","input":{"prompt":"A minimalist product poster for a new iced oolong milk tea: the cup sits on a warm beige background with a few scattered tea leaves and fine condensation on the glass. A thin serif headline reads \"MOUNTAIN OOLONG\" at the top, with a small caption \"New arrival · Autumn edition\" at the bottom. Soft natural side light, clean commercial photography.","aspect_ratio":"auto","enable_web_search":false,"num_images":1,"output_format":"png","resolution":"1K","system_prompt":"","thinking_level":"medium"}}'
# Poll every 5 seconds for up to 25 minutes until status is completed or failed.
# Still queued (with queue_position) 5 minutes after submission: failed with queue_timeout, not charged.
# No result 15 minutes after acceptance (or no confirmation 15 minutes after submission): failed with generation_timeout, not charged.
# Any failure is final: generate again in a new directory (a new X-Request-Id).
# A 404 means the POST did not arrive: rerun this script to resend it with the same ID.
curl --fail-with-body 'https://api.musespan.com/v1/model-tasks/'"$REQUEST_ID"'' --header "Authorization: Bearer $MUSESPAN_API_KEY"