gemini-3-pro-image-preview (Original Format - Text-to-Image)

POST

/google/v1/models/gemini-3-pro-image-preview

The Nano-Banana-Pro model from Google

We at 302 have made 2 optimizations to this interface:
1.
Support returning url or original bs64 data
2.
Support passing in image_url to edit images

Pricing: Input 2 PTC/1M Tokens, Output 120 PTC/1M Tokens

Request

Query Params

Header Params

Body Params application/json

Example

{
  "contents": [
    {
      "parts": [
        {
          "text": "Hi, can you create a 3d rendered image of a pig with wings and a top hat flying over a happy futuristic scifi city with lots of greenery?"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspect_ratio": "4:3"
    }
  }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/google/v1/models/gemini-3-pro-image-preview?response_format' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "contents": [
    {
      "parts": [
        {
          "text": "Hi, can you create a 3d rendered image of a pig with wings and a top hat flying over a happy futuristic scifi city with lots of greenery?"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspect_ratio": "4:3"
    }
  }
}'

Responses

🟢200OK

application/json

Body

Example

{
    "candidates": [
        {
            "content": {
                "parts": [
                    {
                        "text": "Certainly! Here is your 3D rendered image of a pig with wings and a top hat, soaring over a vibrant, futuristic sci-fi city with abundant greenery.\n"
                    },
                    {
                        "inlineData": {
                            "data": "iVBORw0KGg...",
                            "mimeType": "image/png"
                        }
                    },
                    {
                        "url": "https://file.302.ai/gpt/imgs/20260112/1cc6d6606add49c7b47b584f413e15a8.png"
                    }
                ],
                "role": "model"
            },
            "finishReason": "STOP",
            "index": 0
        }
    ],
    "modelVersion": "gemini-2.5-flash-image",
    "responseId": "DrZkaeGZJdeez7IP_Om04A8",
    "usageMetadata": {
        "candidatesTokenCount": 1325,
        "candidatesTokensDetails": [
            {
                "modality": "IMAGE",
                "tokenCount": 1290
            }
        ],
        "promptTokenCount": 34,
        "promptTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 34
            }
        ],
        "totalTokenCount": 1359
    }
}

Modified at 2025-11-21 02:38:12

Variations（DALL·E 2）

gemini-3-pro-image-preview (Original Format - Image Editing)