Image generation with Gemini (aka Nano Banana)

POST

/v1beta/models/gemini-2.5-flash-image-preview:generateContent

Request

Header Params

Body Params application/json

Example

{
  "contents": [
    {
      "parts": [
        {
          "text": "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme"
        }
      ]
    }
  ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1beta/models/gemini-2.5-flash-image-preview:generateContent' \
--header 'x-goog-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "contents": [
    {
      "parts": [
        {
          "text": "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme"
        }
      ]
    }
  ]
}'

Responses

🟢200OK

application/json

Body

Example

{
    "candidates": [
        {
            "content": {
                "parts": [
                    {
                        "text": "Here is your nano banana dish in a fancy restaurant with a Gemini theme: "
                    },
                    {
                        "inlineData": {
                            "mimeType": "image/png",
                            "data": "XXXXX"
                        }
                    }
                ],
                "role": "model"
            },
            "finishReason": "STOP"
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 17,
        "candidatesTokenCount": 1306,
        "totalTokenCount": 1323,
        "promptTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 17
            }
        ],
        "candidatesTokensDetails": [
            {
                "modality": "IMAGE",
                "tokenCount": 1290
            }
        ]
    },
    "modelVersion": "gemini-2.5-flash-image-preview",
    "responseId": "deO6aLeTE4fYvdIPuIm_kQQ"
}

Modified at 2025-09-05 13:21:17

Get Imagen 4 Task

Image editing (text-and-image-to-image)