Nano-banana-3.1-Flash官方格式 gemini-3-pro-image-preview

方法: POST路径: /v1beta/models/gemini-3.1-flash-image-preview:generateContent

官方文档： https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn#aspect_ratios

请求参数

Header 参数

Content-Type
string
必需
示例:
application/json
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 application/json

contents
array
[object]
必需
parts
array
[object]
可选
role
string
可选
generationConfig
object
可选
imageConfig
object
可选
responseModalities
array
[string]
可选
示例
{
"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"
]
}
}

请求示例代码

Shell

curl --location --request POST '/v1beta/models/gemini-3.1-flash-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"
        ]
    }
}'

返回响应

🟢 200 成功

内容类型: application/json

响应结构

object

示例

{}