curl --request POST \
  --url https://api.modellix.ai/api/v1/google/nano-banana-2-lite-edit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Transform this into a watercolor painting"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-nblite-edit-001",
    "model_id": "google/nano-banana-2-lite-edit",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-nblite-edit-001"
    }
  }
}

{
  "code": 400,
  "message": "Invalid parameters: parameter 'prompt' is required"
}

{
  "code": 401,
  "message": "Authentication failed: invalid API key"
}

{
  "code": 429,
  "message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}

{
  "code": 500,
  "message": "Internal server error"
}

Nano Banana 2 Lite Edit

[Core Function] Nano Banana 2 Lite Edit (Gemini 3.1 Flash Lite Image) is the lightweight, cost-efficient image editing model of the Nano Banana 2 family; it transforms one or more input images per a text instruction. [Strengths] It performs fast, low-cost instruction-based editing across up to 14 input images. [Best For] Highly recommended for: high-volume edits, quick style transforms, and batch background or attribute changes where cost and throughput matter. [Limitations] Do NOT use this model when you need the highest edit fidelity or richest detail; use Nano Banana 2 Edit or Nano Banana Pro Edit instead. [Routing] Choose the Lite variant for cost- and throughput-sensitive edits; step up to Nano Banana 2 Edit for higher quality.

POST

google

nano-banana-2-lite-edit

curl --request POST \
  --url https://api.modellix.ai/api/v1/google/nano-banana-2-lite-edit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Transform this into a watercolor painting"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-nblite-edit-001",
    "model_id": "google/nano-banana-2-lite-edit",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-nblite-edit-001"
    }
  }
}

{
  "code": 400,
  "message": "Invalid parameters: parameter 'prompt' is required"
}

{
  "code": 401,
  "message": "Authentication failed: invalid API key"
}

{
  "code": 429,
  "message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}

{
  "code": 500,
  "message": "Internal server error"
}

Authorizations

Authorization

string

header

required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

At least one of image or video must be provided. Both may be provided together.

prompt

string

required

Editing instruction describing the desired transformation

Minimum string length: 1

Example:

"Transform this into a watercolor painting"

image

string[]

Input image URLs. At least one of image or video must be provided. Supports up to 14 images, or up to 10 images when video is also provided.

Required array length: 1 - 14 elements

Image URL (e.g. https://example.com/image.jpg).

Example:

["https://example.com/image.jpg"]

video

string

Input video URL. At least one of image or video must be provided. Must be a publicly accessible HTTPS URL without cookies, authentication, or custom headers. Maximum file size: 15 MB.

Example:

"https://example.com/video.mp4"

videoMimeType

enum<string>

MIME type of the input video. Requires video.

Available options:

video/mp4,

video/mpeg,

video/mpg,

video/mpegps,

video/mov,

video/avi,

video/wmv,

video/flv

Example:

"video/mp4"

aspectRatio

enum<string>

default:1:1

Output image aspect ratio

Available options:

1:1,

1:4,

1:8,

2:3,

3:2,

3:4,

4:1,

4:3,

4:5,

5:4,

8:1,

9:16,

16:9,

21:9

Example:

"16:9"

imageSize

enum<string>

Output image resolution (Flash Lite supports 1K only)

Available options:

1K

Example:

"1K"

Response

Task submitted successfully

code

integer

required

Response code, 0 indicates success

Example:

0

message

string

required

Response message

Example:

"success"

data

object

required

Detailed data about the submitted asynchronous task.

Show child attributes

Nano banana 2 edit Nano banana edit