图像生成（Gemini 原生）

POST

/v1beta/models/gemini-3.1-pro-image:generateContent

真实请求路径：POST /v1beta/models/{model}:generateContent

Google 原生格式生成图像。{model} 填 "gemini-3.1-pro-image"

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Body 参数application/json必填

示例

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "draw a cat"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "IMAGE"
        ]
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1beta/models/gemini-3.1-pro-image:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "draw a cat"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "IMAGE"
        ]
    }
}'

返回响应

🟢200

成功

该响应没有 Body

修改于 2026-05-06 07:20:17

编辑图像 / Edit Images (gpt-image-2)

图像生成（Gemini 原生）