Generate Image (Nano Banana)

POST

/v1beta/models/{model}:generateContent

Google Gemini API request.
Path format: /v1beta/models/{model_name}:{action}
Optional model IDs, e.g.:

gemini-2.5-flash-image (Nano Banana)

gemini-3.1-flash-image-preview (Nano Banana 2)

gemini-3-pro-image-preview (Nano Banana Pro)

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Text-to-ImageImage-to-Image

{
    "contents": [
        {
            "parts": [
                {
                    "text": "a dragon flying over mountains"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "IMAGE"
        ],
        "imageConfig": {
            "aspectRatio": "16:9",
            "imageSize": "2K"
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Text-to-ImageImage-to-Image

curl --location 'https://www.aiide.com/v1beta/models/gemini-2.5-flash-image:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "parts": [
                {
                    "text": "a dragon flying over mountains"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "IMAGE"
        ],
        "imageConfig": {
            "aspectRatio": "16:9",
            "imageSize": "2K"
        }
    }
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "candidates": [
        {
            "content": {
                "role": "string",
                "parts": [
                    {
                        "inlineData": {
                            "mimeType": "string",
                            "data": "string"
                        }
                    }
                ],
                "title": null,
                "description": null
            },
            "finishReason": "string",
            "index": 0
        }
    ],
    "title": null,
    "description": null
}

🟠429Rate Limit

🟠400Bad Request

Modified at 2026-09-10 05:58:22

Text Chat (Preferred)

Text Chat