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

**Method**: `POST`
**Endpoint**: `/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

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

### Body Parameters application/json

```text
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

```bash
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

```text
object
```

#### Example

```json
{}
```