POST /v1beta/models/gemini-3-pro-image-preview:generateContent

Method: POSTEndpoint: /v1beta/models/gemini-3-pro-image-preview:generateContent

Official Documentation： https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn#aspect_ratios

Request Parameters

Header Parameters

Content-Type
string
Required
Example:
application/json
Authorization
string
Optional
Default Value:
Bearer {{YOUR_API_KEY}}

Body Parameters application/json

contents
array
[object]
Required
parts
array
[object]
Optional
role
string
Optional
generationConfig
object
Optional
imageConfig
object
Optional
responseModalities
array
[string]
Optional
Example
{
"contents"
:
[
{
"parts"
:
[
{
"inlineData"
:
{
"data"
:
"iVBORw0KGgoAAAANSUh....."
,
"mimeType"
:
"image/png"
}
}
,
{
"inlineData"
:
{
"data"
:
"iVBORw0KGgoAAAANSUh....."
,
"mimeType"
:
"image/png"
}
}
,
{
"text"
:
"hi"
}
]
,
"role"
:
"user"
}
]
,
"generationConfig"
:
{
"imageConfig"
:
{
"aspectRatio"
:
"3:4"
,
"imageSize"
:
"2K"
}
,
"responseModalities"
:
[
"IMAGE"
]
}
}

Example Request

Shell

curl --location --request POST '/v1beta/models/gemini-3-pro-image-preview:generateContent' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contents": [
        {
            "parts": [
                {
                    "inlineData": {
                        "data": "iVBORw0KGgoAAAANSUh.....",
                        "mimeType": "image/png"
                    }
                },
                {
                    "inlineData": {
                        "data": "iVBORw0KGgoAAAANSUh.....",
                        "mimeType": "image/png"
                    }
                },
                {
                    "text": "hi"
                }
            ],
            "role": "user"
        }
    ],
    "generationConfig": {
        "imageConfig": {
            "aspectRatio": "3:4",
            "imageSize": "2K"
        },
        "responseModalities": [
            "IMAGE"
        ]
    }
}'

Response

🟢 200 Success

Content Type: application/json

Response Schema

object

Example

{}