Nano Banana 2.1

Name: Nano Banana 2.1
Brand: Google
Price: 0.04 USD
Author: MuseSpark

99.9% SLA
Official Discounts
Pay-as-you-go
Fast & Low Latency

Brand:

Input token: $1.50/MOutput token: $7.50/MImage input token: $1.50/MImage output token: $30.00/M

Integrate this model with one task-based API flow

Nano Banana 2.1 The examples below are rendered from Nano Banana 2.1, the current gateway base URL, and the selected public model contract.

Input mode

X-API-Key on every request

POST /api/v1/openapi/task

GET /api/v1/openapi/task/status/{task_id}

Async task workflow

Single code window

Switch language once. Each example already includes both the task creation request and the task status polling request.

Unified Example

API_KEY="<API_KEY>"
BASE_URL="https://api.musespark.ai"
REQUEST_BODY='{
  "model_id": "nano-banana-2.1",
  "parameters": {
    "prompt": "A cinematic portrait with soft lighting",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "batch_size": 1
  }
}'

CREATE_RESPONSE=$(curl --request POST "$BASE_URL/api/v1/openapi/task" \
  --header "X-API-Key: $API_KEY" \
  --header "Content-Type: application/json" \
  --data-raw "$REQUEST_BODY")

TASK_ID="<TASK_ID_FROM_CREATE_RESPONSE>"

curl "$BASE_URL/api/v1/openapi/task/status/$TASK_ID" \
  --header "X-API-Key: $API_KEY"

Request and response JSON become the documentation

Keep the payload and task status envelope as the primary contract. Field descriptions, optionality, and enum hints now live inline as JSON comments.

Request Body

Caller payload

This is the request envelope accepted by the public gateway for the selected model contract.

Field comments and caller parameters come directly from the current item's model schema.

{

"model_id": "nano-banana-2.1",// target model

"parameters": {

"prompt": "A cinematic portrait with soft lighting",// image generation or reference-image editing prompt · min 1 · min length 1

"resolution": "1K",// 1K, 2K and 4K, with lowercase aliases accepted. All 14 documented aspect ratios are supported at every tier. Defaults to 1K · enum: 1K | 2K | 4K

"aspect_ratio": "1:1",// enum: auto | 1:4 | 4:1 | 1:8 | 8:1 | 1:1 | 2:3 | 3:2 | 3:4 | 4:3 | 4:5 | 5:4 | 9:16 | 16:9 | 21:9

"batch_size": 1// museSpark batch count; each child task requests one provider output · min 1 · max 15

}

Response Body

Gateway response

This is the task status response you will query with task_id until the task reaches a terminal state.

Poll every 2-5 seconds and stop once status becomes completed, failed, cancelled.

{

"code": 200,// 200 on success

"msg": "success",

"data": {

"task_id": "task_01HQX8N2QJ0YQ8Q0T7G6N4V6K2",// use for status polling

"status": "completed",// enum: queued | running | completed | failed | cancelled

"progress": 100,// 0-100 if available

"completed_at": 1760000000,// unix timestamp

"expires_at": 1760001800,// unix timestamp

"result": {

"output_urls": [// generated files

"https://cdn.example.com/output.png"

]

}

No Read me document is available for this model yet.

Why Choose MuseSpark?

Model & Modality	Credits / 1M tokens	Our Price (USD)
Input token	150/M	$1.50/M
Output token	750/M	$7.50/M
Image input token	150/M	$1.50/M
Image output token	3,000/M	$30.00/M

Reference prices

Use these prices to compare output options. You are billed for actual token usage at the rates above.

Output options	Credits / image	Price (USD) / image
1K · 1K	≈ 4.125	≈ $0.0413
2K · 2K	≈ 5.805	≈ $0.0581
4K · 4K	≈ 12.105	≈ $0.1211

Nano Banana 2.1