curl --request POST \
  --url https://api.modellix.ai/api/v1/google/nano-banana-2.1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A colorful abstract painting with flowing shapes"
}
'

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

{
  "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.1

[Core Function] Nano Banana 2.1 is Google’s fast text-to-image model on Gemini 3.6 Flash, exposed as google/nano-banana-2.1. [Strengths] It keeps Flash-level speed at 1K, 2K, and 4K, with stronger visual quality, text rendering, and real-world knowledge than Nano Banana 2. thinkingLevel trades latency for quality and defaults to medium. Optional systemInstruction is omitted when blank. enableWebSearch turns on Google Search grounding (web and image search) only when true. [Best For] High-volume image production, posters and diagrams with readable text, localized text, and rapid iteration on new text-to-image work. [Limitations] Do NOT use this model for image or video editing, 512-pixel output, audio input, or reference images. This endpoint accepts a prompt only. seed, temperature, topP, topK, and logprobs are rejected. [Routing] Use google/nano-banana-2.1 for new text-to-image work. Use google/nano-banana-2 when the caller needs the 512 resolution of Gemini 3.1 Flash Image. Use google/nano-banana-2.1-edit when the user supplies images or a video. Use google/nano-banana-pro when the user wants the highest-end professional stills.

POST

/

google

/

nano-banana-2.1

curl --request POST \
  --url https://api.modellix.ai/api/v1/google/nano-banana-2.1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A colorful abstract painting with flowing shapes"
}
'

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

{
  "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

prompt

string

required

Image description text

Minimum string length: 1

Example:

"A colorful abstract painting with flowing shapes"

aspectRatio

enum<string>

default:1:1

Image aspect ratio. Defaults to 1:1.

Available options:

1:1,

3:2,

2:3,

3:4,

1:4,

4:1,

4:3,

4:5,

5:4,

1:8,

8:1,

9:16,

16:9,

21:9,

9:21

Example:

"1:1"

imageSize

enum<string>

default:1K

Output image resolution. Defaults to 1K. 512 is not supported.

Available options:

1K,

2K,

4K

Example:

"1K"

thinkingLevel

enum<string>

default:medium

Thinking effort. minimal is fastest; high spends more thinking. Defaults to medium.

Available options:

minimal,

medium,

high

Example:

"medium"

systemInstruction

string

Optional system instruction. Omitted when empty. Not sent upstream when blank.

enableWebSearch

boolean

When true, enables Google Search grounding with web search and image search. Image search cannot be used to look up people. Omitted or false does not send the tool. Search uses extra tokens.

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