Nano Banana 2

POSThttps://api.newportai.com/api/async/google_gemini_image

The Nano Banana 2 API leverages the Gemini 3.1 Flash Image model to generate high-quality images from text prompts. It delivers fast, cost-efficient image generation with support for multiple resolutions up to 4K.

Submit a POST request with your text prompt and configuration to obtain a taskId.
Submit a POST request to the Polling API with the taskId to retrieve the generated images.
Configure a Callback URL to receive results automatically on completion.

Request Headers

Content-Type string Required

Enum: application/json

Authorization string Required

Bearer authentication token. Example: Bearer {{APIKey}}.

Request Body

model string Required

The model identifier. Must be set to gemini-3.1-flash-image for Nano Banana 2.

text string Required

The text prompt describing the image to generate. Example: "The kitten is eating".

imageSize string Optional

The output image resolution. Supported values for Nano Banana 2: "512", "1K", "2K", "4K". Default: "1K".

aspectRatio string Optional

The aspect ratio of the generated image. Example: "16:9", "1:1", "4:3".

images array[string] Optional

An array of reference image URLs for image-to-image generation. Can be empty or omitted. Example: ["https://d2t5pyzt5qvy2d.cloudfront.net/..."].

Response

code integer

Returns 0 for success, or a specific error code.

message string

Returns "success" or a descriptive error message.

data object

taskId string

The unique identifier for the task. Use this ID with the Polling API to retrieve the generated output.

Errors

10192Illegal param. One or more request parameters are invalid or missing.

Polling

Use the Polling API to retrieve the processing results.

Callback

Alternatively, you can enable Callback to receive task results automatically on completion.

0Task Completed (status: 3)

123456789101112131415161718192021{
  "code": 0,
  "message": "success",
  "data": {
    "images": [
      {
        "imageUrl": "https://dreamface-resource.oss-us-east-1.aliyuncs.com/df-ability-tmp/0a2f83e6-21e7-47c7-ab50-74457845d628.jpeg",
        "imageType": "png"
      }
    ],
    "task": {
      "taskId": "API-605f75923ff64b998955ba46f13915f2",
      "status": 3,
      "errorCode": 0,
      "reason": "ok",
      "taskType": "google_gemini_image",
      "executionTime": 26446,
      "expire": 1778593345400
    }
  }
}

Request

cURL

123456789101112curl -X POST 'https://api.newportai.com/api/async/google_gemini_image' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {{APIKey}}' \
  -d '{
  "model": "gemini-3.1-flash-image",
  "text": "The kitten is eating",
  "aspectRatio": "16:9",
  "imageSize": "1K",
  "images": [
    "https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/VE-i9SzS3ZRdVTSzJWTcA.jpeg"
  ]
}'

0Successful

1234567{
    "code": 0,
    "message": "success",
    "data": {
        "taskId": "API-605f75923ff64b998955ba46f13915f2"
    }
}