Nano Banana 2.1

POST

tasks

Nano Banana 2.1

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "image_urls": [
    "<string>"
  ],
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "n": 123
}
'

import requests

url = "https://api.qingbo.ai/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "image_urls": ["<string>"],
    "aspect_ratio": "<string>",
    "resolution": "<string>",
    "n": 123
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    image_urls: ['<string>'],
    aspect_ratio: '<string>',
    resolution: '<string>',
    n: 123
  })
};

fetch('https://api.qingbo.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"n\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qingbo.ai/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"n\": 123\n}")
  .asString();

Nano Banana 2.1 (gemini-nano-banana-2.1) is Google’s image model for text-to-image and editing with up to 14 reference images. It outputs at 1k, 2k and 4k, returns up to 4 images per request, and is billed from actual token usage. It is a different model from Nano Banana 2 (gemini-3.1-flash-image, see Nano Banana Official): there is no 0.5k tier and no google_search or google_image_search, so drop those when migrating from Nano Banana 2. When the price of an image has to be known before submission, use Nano Banana 2.1 Economy.

The official and economy lines never switch automatically: the model ID selects the line.

Quick start

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: nb21-001" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "action": "generate",
    "prompt": "A celadon teacup on an oak table, natural window light, product photography",
    "aspect_ratio": "1:1",
    "resolution": "2k",
    "n": 1
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: nb21-batch-001" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "action": "generate",
    "prompt": "A minimalist cafe logo on an off-white background, clean lines",
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "n": 4
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: nb21-edit-001" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "action": "edit",
    "prompt": "Keep the subject, replace the background with a bamboo grove at dawn",
    "image_urls": ["https://cdn.example.com/source.png"],
    "aspect_ratio": "auto",
    "resolution": "1k"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "action": "edit",
    "prompt": "Place the person from the first image into the scene from the second, matching the light",
    "image_urls": [
      "https://cdn.example.com/person.png",
      "https://cdn.example.com/scene.png"
    ],
    "aspect_ratio": "16:9",
    "resolution": "4k"
  }'

A successful submission returns a task_id. Retrieve the result with GET /v1/tasks/{task_id}, wait inline with Prefer: wait, or configure a webhook.

Request parameters

string

required

Must be gemini-nano-banana-2.1.

string

default:"generate"

generate — generate from text
edit — rewrite from reference images; image_urls is required

Image-to-image and multi-reference blending both use edit; the only difference is how many entries image_urls carries.

string

required

Image description or editing instruction, in English or Chinese.

string[]

Reference image URLs. Required for edit, up to 14. Reference images are billed as image input — see “Pricing”.

string

default:"auto"

Frame ratio: 14 fixed ratios plus auto — auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1.1:4, 4:1, 1:8 and 8:1 suit long horizontal and vertical banners and are available at 1k, 2k and 4k.auto lets the model decide: it picks from the prompt for text-to-image, and follows the input image for edits. When omitted, auto is used.

string

default:"1k"

Output resolution: 1k, 2k or 4k. 0.5k is not supported and returns 400.

integer

default:"1"

Number of images to generate, 1–4. Each image is billed for its own output image tokens, so a larger n costs more.

See Submit a task for callback_url, callback_events, Prefer: wait, Idempotency-Key and the maximum-cost header.

Nano Banana 2.1 does not support mask_url, quality or seed, and does not accept Nano Banana 2’s google_search or google_image_search. Any other parameter returns 400 and is not billed. For masked inpainting use gpt-image-2.

Limits

Condition	Limit
Per request	Up to 4 images per request.
`action: "edit"`	Add at least one reference image to edit
Reference images	Up to 14
Resolution	`1k`, `2k`, `4k`; `0.5k` is not supported

Pricing

Billed from actual token usage across four dimensions:

Dimension	Covers	`price_config.image_usage_rates` key
Text input	The prompt	`text_input`
Reference image input	Each image in `image_urls`	`image_input`
Text output	The thinking text the model produces while generating	`text_output`
Image output	Each generated image	`image_output`

More reference images, a higher resolution and a larger n all raise the cost of a call.

Rates are in price_config on GET /v1/models and in the console’s Model Market.What a single call actually cost is the cost field on the task response: an integer quota at 500,000 quota = 1 USD, not dollars.

Holds and settlement

Submitting a task places a hold for the estimated usage; the task then settles from actual usage and the difference is released. The settled amount never exceeds the hold. The estimate is built from:

Image output — expected output tokens per image, looked up by resolution, multiplied by n
Text output — reserved at the model’s maximum output tokens, once per request
Text input — reserved by the prompt’s byte length, with a floor of 64
Reference images — 768px tiles at 258 tokens per tile

Because text output is reserved at the model’s ceiling, the hold is usually well above the final settled amount, and the difference is released when the task finishes. The estimated output tokens per resolution are in price_config.image_usage_reservation on GET /v1/models. You are only billed for a successfully generated image. Failed and cancelled tasks, and tasks that return no usable image, are refunded in full.

Response

Completed task

{
  "task_id": "task-wave1791564843b950000001",
  "model": "gemini-nano-banana-2.1",
  "action": "generate",
  "status": "completed",
  "progress": "100%",
  "created_at": 1791564843,
  "completed_at": 1791564885,
  "billing_status": "settled",
  "cost": 41873,
  "result": {
    "images": [
      {
        "expires_at": 1792169685,
        "url": ["https://cdn.example.com/result-1.jpg"]
      },
      {
        "expires_at": 1792169685,
        "url": ["https://cdn.example.com/result-2.jpg"]
      }
    ]
  },
  "urls": {
    "get": "https://api.qingbo.ai/v1/tasks/task-wave1791564843b950000001",
    "cancel": "https://api.qingbo.ai/v1/tasks/task-wave1791564843b950000001/cancel"
  }
}

The example above is the result of n: 2. result.images has one entry per image, where url is an array and expires_at is when the link stops working. See Query Task Status for the full field list.

Nano Banana 2.1

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "image_urls": [
    "<string>"
  ],
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "n": 123
}
'

import requests

url = "https://api.qingbo.ai/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "image_urls": ["<string>"],
    "aspect_ratio": "<string>",
    "resolution": "<string>",
    "n": 123
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    image_urls: ['<string>'],
    aspect_ratio: '<string>',
    resolution: '<string>',
    n: 123
  })
};

fetch('https://api.qingbo.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"n\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qingbo.ai/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"n\": 123\n}")
  .asString();

Text Generation

Image Generation

Video Generation

Audio

Tools & Embeddings

Task Management

Account & Usage

Quick start

Request parameters

Limits

Pricing

Holds and settlement

Response

​Quick start

​Request parameters

​Limits

​Pricing

​Holds and settlement

​Response

​Related

Quick start

Request parameters

Limits

Pricing

Holds and settlement

Response

Related