stable

Nano Banana 2.1 · Image to Image

Edit an image or combine visual references with Nano Banana 2.1. Provide image URLs and a prompt describing what to change, then retrieve the result from the asynchronous task.

Developer API pricing

Provider: SeeAPI

USD estimate: $0.0037 / credit · Estimated equivalent, not an additional charge.

1K: 6 credits/gen (≈ $0.022/gen)

2K: 10 credits/gen (≈ $0.037/gen)

4K: 12 credits/gen (≈ $0.045/gen)

Request

POST/v1/generations

AuthorizationSend your API key in the Authorization header using the Bearer scheme.Authorization: Bearer ****************

Header Params

stringrequired

A new, stable key for each generation request. Reuse it only when retrying the same request body.

max length: 255

Example:: order-20260818-001

Body Params

application/json

stringrequired

The model ID shown in the selected model's API documentation.

Allowed:nano-banana-2-1

Default:: nano-banana-2-1
Example:: nano-banana-2-1

stringrequired

Image to Image. Use the Endpoint ID shown in this model's API documentation.

Allowed:image-to-image

Default:: image-to-image
Example:: image-to-image

stringoptional

Optional public Provider ID. Omit it to use the Endpoint default Provider (seeapi).

Allowed:seeapi

Default:: seeapi
Example:: seeapi

objectrequired

Image editing settings and reference image URLs. Supply the fields listed under your selected provider.

Provider parameters

SeeAPIseeapiDefault Provider

array <uri>required

URLs of the images to edit or use as visual references. Supply the references together in this array. Accepted formats: JPEG, PNG, WebP. Maximum file size: 30 MB per file.

min items: 1max items: 10

Example:: ["https://client.example.com/input.png"]

stringrequired

Describe the changes to make and the details to preserve. When using several references, explain the role of each image in the order supplied.

max length: 20000

Example:: Replace the background with a warm ivory studio backdrop. Keep the product shape, color, and label unchanged, and add a soft natural shadow.

stringoptional

Choose the output proportions, or use auto for automatic selection.

Allowed:auto1:12:33:21:44:13:44:34:55:41:88:19:1616:921:9

Default:: auto

stringoptional

Choose the output resolution tier. Higher resolutions use more credits.

Allowed:1K2K4K

Default:: 1K

stringoptional

Choose PNG or JPEG for the generated image.

Allowed:pngjpg

Default:: png

string <uri>optional

An absolute HTTPS URL that receives the terminal generation Webhook.

max length: 2048

Example:: https://client.example.com/webhooks/seeapi

Responses

202Generation accepted and processing

Bodyapplication/json

objectrequired

stringrequired

The generation ID to use when querying task progress and results.

Example:: task_xxx

stringrequired

Example:: nano-banana-2-1

stringrequired

Example:: image-to-image

stringrequired

Allowed:seeapi

seeapi: SeeAPI

Example:: seeapi

stringrequired

The task status at the time of this response. Processing means the image is not ready yet.

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 6

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

200Idempotent replay of an existing generation request

Bodyapplication/json

objectrequired

stringrequired

The generation ID to use when querying task progress and results.

Example:: task_xxx

stringrequired

Example:: nano-banana-2-1

stringrequired

Example:: image-to-image

stringrequired

Allowed:seeapi

seeapi: SeeAPI

Example:: seeapi

stringrequired

The task status at the time of this response. Processing means the image is not ready yet.

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 6

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

400

Invalid JSON or unsupported request parameters. Check the field names, required values, and allowed options.

401

Invalid API Key or authentication failed

402

Insufficient credits

403

The current request is not allowed

404

Model, Endpoint, or task not found

409

Idempotency conflict or the same request is still being created

413

Request body is too large

429

Too many requests

503

Service temporarily unavailable

Query Task Status

After submitting a task, use the unified query endpoint to check progress and retrieve results:

Get Task DetailsLearn how to query task status and retrieve generation results

A successful creation response means the task was accepted, not that the image is ready. Keep the returned generation ID and query the task until it reaches a terminal status.

Callbacks

Manage the secret used to verify generation webhook signatures. Callback URLs are supplied when you create each generation.

Webhook flow

Callback URL per generation.

Webhook signing key

Related Resources

Market Overview

Explore all available models

Credits & Billing

View credit balance, plans, and billing activity

Usage

Review API usage and credit consumption

Code Examples

Request

const response = await fetch("https://api.seeapi.com/v1/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Idempotency-Key": "order-20260818-001",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "nano-banana-2-1",
  "endpoint": "image-to-image",
  "provider": "seeapi",
  "input": {
    "input_images": [
      "https://client.example.com/input.png"
    ],
    "prompt": "Replace the background with a warm ivory studio backdrop. Keep the product shape, color, and label unchanged, and add a soft natural shadow.",
    "aspect_ratio": "auto",
    "resolution": "1K",
    "output_format": "png"
  },
  "callback_url": "https://client.example.com/webhooks/seeapi"
})
});

const result = await response.json();

ResponseHTTP 202

{
  "generation": {
    "id": "task_xxx",
    "model": "nano-banana-2-1",
    "endpoint": "image-to-image",
    "provider": "seeapi",
    "status": "processing",
    "estimated_credits": 6,
    "consumed_credits": 0,
    "refunded_credits": 0,
    "created_at": "2026-08-18T10:00:00Z",
    "updated_at": "2026-08-18T10:00:00Z"
  },
  "idempotent": false
}

const response = await fetch("https://api.seeapi.com/v1/generations", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Idempotency-Key": "order-20260818-001", "Content-Type": "application/json" }, body: JSON.stringify({ "model": "nano-banana-2-1", "endpoint": "image-to-image", "provider": "seeapi", "input": { "input_images": [ "https://client.example.com/input.png" ], "prompt": "Replace the background with a warm ivory studio backdrop. Keep the product shape, color, and label unchanged, and add a soft natural shadow.", "aspect_ratio": "auto", "resolution": "1K", "output_format": "png" }, "callback_url": "https://client.example.com/webhooks/seeapi" }) }); const result = await response.json();

{ "generation": { "id": "task_xxx", "model": "nano-banana-2-1", "endpoint": "image-to-image", "provider": "seeapi", "status": "processing", "estimated_credits": 6, "consumed_credits": 0, "refunded_credits": 0, "created_at": "2026-08-18T10:00:00Z", "updated_at": "2026-08-18T10:00:00Z" }, "idempotent": false }

Responses

202Generation accepted and processing

Bodyapplication/json

objectrequired

stringrequired

The generation ID to use when querying task progress and results.

Example:: task_xxx

stringrequired

Example:: nano-banana-2-1

stringrequired

Example:: image-to-image

stringrequired

Allowed:seeapi

seeapi: SeeAPI

Example:: seeapi

stringrequired

The task status at the time of this response. Processing means the image is not ready yet.

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 6

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

200Idempotent replay of an existing generation request

Bodyapplication/json

objectrequired

stringrequired

The generation ID to use when querying task progress and results.

Example:: task_xxx

stringrequired

Example:: nano-banana-2-1

stringrequired

Example:: image-to-image

stringrequired

Allowed:seeapi

seeapi: SeeAPI

Example:: seeapi

stringrequired

The task status at the time of this response. Processing means the image is not ready yet.

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 6

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

400

Invalid JSON or unsupported request parameters. Check the field names, required values, and allowed options.

401

Invalid API Key or authentication failed

402

Insufficient credits

403

The current request is not allowed

404

Model, Endpoint, or task not found

409

Idempotency conflict or the same request is still being created

413

Request body is too large

429

Too many requests

503

Service temporarily unavailable