Nano Banana 2 Lite API

Connect in three steps

1. Get a keyCreate a key in the dashboard after you confirm your email. One key opens every model.
2. Check the pricePOST /v1/price shows the cost of a run in advance, without charging you.
3. Run a task and collect the resultPOST /v1/tasks starts a task, GET /v1/tasks/{id} shows its status and files.

Ready-to-use code

Replace YOUR_API_KEY with your key. The code starts a task and waits for the result. In cURL, repeat the second request with the id from the first response instead of TASK_ID until status becomes succeeded.

curl -X POST "https://api.cyhub.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "banana2_lite",
  "settings": {
    "prompt": "Уютная кофейня в дождливый вечер, тёплый свет из окон",
    "size": "16:9"
  }
}'

curl "https://api.cyhub.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

import time

import requests

API = "https://api.cyhub.ai/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

body = {
    "model": "banana2_lite",
    "settings": {
        "prompt": "Уютная кофейня в дождливый вечер, тёплый свет из окон",
        "size": "16:9",
    },
}

response = requests.post(f"{API}/tasks", json=body, headers=HEADERS, timeout=60)
response.raise_for_status()
task = response.json()
while task["status"] in ("queued", "running"):
    time.sleep(5)
    task = requests.get(f"{API}/tasks/{task['id']}", headers=HEADERS, timeout=30).json()
print(task["status"], task["result"])

const API = "https://api.cyhub.ai/v1";
const HEADERS = { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" };

const body = {
  "model": "banana2_lite",
  "settings": {
    "prompt": "Уютная кофейня в дождливый вечер, тёплый свет из окон",
    "size": "16:9"
  }
};

async function main() {
  let response = await fetch(`${API}/tasks`, { method: "POST", headers: HEADERS, body: JSON.stringify(body) });
  if (!response.ok) throw new Error(await response.text());
  let task = await response.json();
  while (task.status === "queued" || task.status === "running") {
    await new Promise((resolve) => setTimeout(resolve, 5000));
    response = await fetch(`${API}/tasks/${task.id}`, { headers: HEADERS });
    task = await response.json();
  }
  console.log(task.status, task.result);
}

main();

Price before the run

Prices as of 15.10.2026: from 5 ₽. POST /v1/price shows the exact price of your settings.

Send the same settings to POST /v1/price: the response shows the price of the run without charging you.

curl -X POST "https://api.cyhub.ai/v1/price" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "banana2_lite",
  "settings": {
    "prompt": "Уютная кофейня в дождливый вечер, тёплый свет из окон",
    "size": "16:9"
  }
}'

• amount_minor: the price of the run in minor units (kopecks for rubles)
• currency: the wallet currency
• available_minor: how much your balance has for new tasks right now

Parameters

Model parameters go inside settings. Omitted optional fields take their default values.

promptRequired

What to draw, or what to do with the reference images.

Type: StringMinimum characters: 1Maximum characters: 5000

sizeOptional

Aspect ratio. Auto: the model picks it itself.

Type: StringAllowed values: auto1:11:41:82:33:23:44:14:34:55:48:19:1616:921:9Default: "9:16"

image_urlsOptional

Reference image URLs, up to 10. Without them the image is made from the description only.

Type: List (String, uri)Maximum items: 10

Parameters not listed here are not accepted: the response is 422 unknown_setting.

Input

• Reference images are URLs of JPEG, PNG or WebP files, up to 30 MB each.

Request example

Send this JSON to POST /v1/tasks with your API key. To check the price first, send the same JSON to POST /v1/price.

{
  "model": "banana2_lite",
  "settings": {
    "prompt": "Уютная кофейня в дождливый вечер, тёплый свет из окон",
    "size": "16:9"
  }
}

{
  "model": "banana2_lite",
  "settings": {
    "prompt": "Замени фон на летний луг, человека оставь как есть",
    "size": "auto",
    "image_urls": [
      "https://example.com/photo.jpg"
    ]
  }
}

The price is calculated when the task is accepted, currency RUB.

Output

• One image per run, 1K resolution.

A finished task as GET /v1/tasks/{id} returns it (some fields left out). The caption may sit on the task or on a single file and may be empty; the model picks the file name.

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Caption of the result: the model and its settings",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "image",
        "filename": "image.png",
        "size": 1843200,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      }
    ]
  }
}

See also

• Nano Banana 2 Lite: features and prices
• Similar models: GPT Image 2.5 API, Nano Banana Pro API, Midjourney 8.2 API, Grok Imagine 2.0 API, Seedream 5.0 PRO API, Recraft API
• API documentation
• API errors and how to handle them