nano banana api

Payload fields

• prompt (required): description to generate.
• model (required): nano-banana-fast | nano-banana | nano-banana-pro.
• mode (optional): text-to-image (default) or image-to-image; image mode needs a reference image.
• aspectRatio (optional): default auto; accepts 1:1, 16:9, 9:16, etc.
• imageSize (optional): default 1K; accepts 1K/2K/4K.
• imageData (optional): base64 data URL with data:image/xxx;base64, prefix.
• imageUrl (optional): reference image URL used when imageData is absent.

Sample request

curl -X POST https://nanobananapro.cloud/api/v1/image/nano-banana \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer api-key" \
  -d '{
    "prompt": "A banana cat in a spacesuit on the moon",
    "model": "nano-banana-pro",
    "mode": "text-to-image",
    "aspectRatio": "auto",
    "imageSize": "1K"
  }'

Sample response

{
  "data": {
    "id": "task-id-xxx",
    "results": [],
    "progress": 0,
    "status": "running",
    "failure_reason": null,
    "error": null,
    "credits_cost": 20
  }
}

Sample request

curl -X POST https://nanobananapro.cloud/api/v1/image/nano-banana/result \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer api-key" \
  -d '{
    "taskId": "task-id-xxx"
  }'

Sample response

{
  "data": {
    "id": "task-id-xxx",
    "results": [
      {
        "url": "https://example.com/generated.png",
        "content": "A banana cat in a spacesuit on the moon"
      }
    ],
    "progress": 100,
    "status": "succeeded",
    "failure_reason": null,
    "error": null
  }
}