Skip to main content
POST
/
api
/
v1
/
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

Fast & Cost-effective
  • Engine: Gemini 2.5 Flash
  • Aspect Ratios: 16:9, 9:16
  • Resolution: 1K (fixed)
  • Best for: Quick iterations, prototyping
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
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
​
model
string
required
Model name, e.g. nano-banana, nano-banana-2, nano-banana-pro.
​
callBackUrl
string
Webhook callback URL.
​
input
object
required
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.