生成图像

POST

/v1beta/models/{model_name}:generateContent

更新:

2月27日 00:12

新上线 nano-banana-2

模型名称: gemini-3.1-flash-image-preview

小白开箱即用教程（一步一步教你用）

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Body 参数application/json

示例

{
    "contents": [
        {
            "parts": [
                {
                    "text": "生成一副清明上河油画,以图片的形式返回"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "IMAGE"
        ],
        "imageConfig": {
            "aspectRatio": "4:3",
            "imageSize": "4K"
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1beta/models/gemini-3-pro-image-preview:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "parts": [
                {
                    "text": "生成一副清明上河油画,以图片的形式返回"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "IMAGE"
        ],
        "imageConfig": {
            "aspectRatio": "4:3",
            "imageSize": "4K"
        }
    }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{}

修改于 2026-03-04 15:02:44

创建图片编辑

创建图片任务