Text to Image

curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "nano-banana",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "A cute shiba inu running under a starry sky",
    "ratio": "16:9"
  }
}'

curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "nano-banana-pro",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "A cute shiba inu running under a starry sky",
    "ratio": "16:9",
    "resolution": "2k"
  }
}'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

POST

api

task

submit

curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "nano-banana",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "A cute shiba inu running under a starry sky",
    "ratio": "16:9"
  }
}'

curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "nano-banana-pro",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "A cute shiba inu running under a starry sky",
    "ratio": "16:9",
    "resolution": "2k"
  }
}'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Use Gemini-powered Nano Banana models to generate high-quality images from text descriptions. Choose between fast generation and high-quality output.

Available Models

nano-banana · nano-banana-2 · nano-banana-pro

Model Comparison

nano-banana — Gemini 2.5 Flash

Fast & Cost-effective

Engine: Gemini 2.5 Flash
Aspect Ratios: 16:9, 9:16
Resolution: 1K (fixed)
Best for: Quick iterations, prototyping

nano-banana-2 — Gemini 3.1 Flash

Fast & High Quality

Engine: Gemini 3.1 Flash
Aspect Ratios: 16:9, 9:16, 1:1, 4:3, 3:4
Resolutions: 1k, 2k, 4k
Best for: Fast generation with high quality, balanced choice

nano-banana-pro — Gemini 3.0 Pro

High Quality

Engine: Gemini 3.0 Pro
Aspect Ratios: 16:9, 9:16, 1:1, 4:3, 3:4
Resolutions: 1k, 2k, 4k
Best for: Final production, high-quality outputs

string

required

Model name, e.g. nano-banana, nano-banana-2, nano-banana-pro.

string

Webhook callback URL.

object

required

Hide properties

string

required

Prompt describing the image you want to generate.

string

Image aspect ratio. Options: 16:9, 9:16, 1:1, 4:3, 3:4. Default: 16:9.Note: nano-banana only supports 16:9 and 9:16. Other ratios require nano-banana-2 or nano-banana-pro.

string

Image resolution. Options: 1k, 2k, 4k. Default: 1k.Note: nano-banana ignores this parameter (always 1K). Only nano-banana-2 and nano-banana-pro support 2K and 4K.

curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "nano-banana",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "A cute shiba inu running under a starry sky",
    "ratio": "16:9"
  }
}'

curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "nano-banana-pro",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "A cute shiba inu running under a starry sky",
    "ratio": "16:9",
    "resolution": "2k"
  }
}'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Query Result

Retrieve the generation result via the Query Task endpoint or Webhook:

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "SUCCESS",
    "input": {
      "model": "nano-banana-pro",
      "prompt": "A cute shiba inu running under a starry sky",
      "ratio": "16:9",
      "resolution": "2k"
    },
    "result": {
      "type": "image",
      "urls": [
        "https://example.com/output/image-a1b2c3d4.png"
      ]
    },
    "created_at": "2026-02-12T10:00:00.000000Z",
    "updated_at": "2026-02-12T10:00:15.000000Z"
  }
}

Nano Banana returns 1 image per generation. Average generation time: 10-30 seconds.

Overview

Task API

Veo 3 Video

Nano Banana Image

Seedream Image

Grok Imagine (xAI)

GPT Image 2 (OpenAI)

Available Models

Model Comparison

Query Result

​Available Models

​Model Comparison

​Query Result

Available Models

Model Comparison

Query Result