IMAGE API

nano-banana2 · API guide

Integrate nano-banana2 through the media task API. Request examples, parameters, authentication and result handling.

POST/v1/tasksMODELnano-banana2

Official reference gemini-3.1-flash-imageChecked 2026-09-27Official docs

Code examples & responses

Request & responseExamples

POST/v1/tasks

Server-side request

curl "https://newrouters.com/v1/tasks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  --data '{
  "model": "nano-banana2",
  "input": {
    "resolution": "1k",
    "aspect_ratio": "auto",
    "output_format": "jpeg",
    "prompt": "A small red house in a quiet garden",
    "images": []
  }
}'

Server-side request

const apiBaseUrl = "https://newrouters.com";
const apiKey = process.env.API_KEY;
if (!apiKey) throw new Error("Set API_KEY in your server environment");

const response = await fetch(apiBaseUrl + "/v1/tasks", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer " + apiKey
  },
  body: JSON.stringify({
  "model": "nano-banana2",
  "input": {
    "resolution": "1k",
    "aspect_ratio": "auto",
    "output_format": "jpeg",
    "prompt": "A small red house in a quiet garden",
    "images": []
  }
})
});

const result = await response.json();
if (!response.ok) throw new Error(JSON.stringify(result));
console.log(result);

Server-side request

import json
import os
from urllib.request import Request, urlopen

api_base_url = "https://newrouters.com"
api_key = os.environ["API_KEY"]
body = json.loads("{\"model\":\"nano-banana2\",\"input\":{\"resolution\":\"1k\",\"aspect_ratio\":\"auto\",\"output_format\":\"jpeg\",\"prompt\":\"A small red house in a quiet garden\",\"images\":[]}}")

request = Request(
    api_base_url + "/v1/tasks",
    data=json.dumps(body).encode("utf-8"),
    headers={
    "Content-Type": "application/json",
    "Authorization": "Bearer " + api_key
    },
    method="POST",
)
with urlopen(request) as response:
    print(json.load(response))

The API origin is filled in. Set API_KEY before running. Examples never submit automatically.

ResponseSelected fields · illustrative values

202Task accepted

JSON

{
  "id": "TASK_ID",
  "status": "pending",
  "model": "nano-banana2",
  "result": null,
  "error": null
}

200Successful result

JSON

{
  "id": "TASK_ID",
  "status": "succeeded",
  "model": "nano-banana2",
  "result": {
    "assets": [
      "https://example.com/output.png"
    ]
  },
  "error": null
}

Retrieve results after submission

Request lifecycleAsynchronous media

Create a task01
POST /v1/tasks
Submit model + input. Save the returned task id.
202 · pending
Poll status02
GET /v1/tasks/{id}
Wait and poll again while pending or processing.
Wait → poll again
Read the outcome03
result.assets[] / error
Read the result for the terminal task state.
succeeded→ assetsfailed→ error

Use the exact API model ID nano-banana2. This guide describes the platform contract; check the live catalog before calling the model.

Request example

The platform origin is filled in at build time. Set API_KEY to your server-side key before running.

curl "https://newrouters.com/v1/tasks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  --data '{
  "model": "nano-banana2",
  "input": {
    "resolution": "1k",
    "aspect_ratio": "auto",
    "output_format": "jpeg",
    "prompt": "A small red house in a quiet garden",
    "images": []
  }
}'

Retrieve the result

The creation response accepts a task, not the final output. Replace TASK_ID with its returned ID and poll until succeeded or failed.

curl "https://newrouters.com/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer $API_KEY"

Read result on success and error on failure. Keep the original task ID when the upstream outcome is unknown; do not submit a duplicate paid generation.

Parameters

Field	Type	Requirement	Default	Constraints
`images`	array	Optional	`[]`	—
`prompt`	string	Required	—	max length 100000
`resolution`	enum	Optional	`"1k"`	`1k`, `2k`, `4k`
`aspect_ratio`	enum	Optional	`"auto"`	`auto`, `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`, `1:4`, `1:8`, `4:1`, `8:1`
`output_format`	enum	Optional	`"jpeg"`	`png`, `jpeg`, `webp`

Official sources and identity

Checked: 2026-09-27 · Platform model: nano-banana2 · Official reference: gemini-3.1-flash-image

Pricing and troubleshooting

Check current availability, contract and account pricing before integration. Keep request IDs and usage receipts when diagnosing errors. Complete API reference

Task workflow and budget

Follow the task tutorial, then use batch budgeting to reconcile specifications, attempt counts and final charges. Examples do not promise output quality or speed; validate an approved small sample first.