使用 Gemini 3 Pro Image Preview 生成内容

POST

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

使用 Gemini 3 Pro Image Preview（Nano Banana Pro）模型生成图片。这是一款先进的图片生成和编辑模型，针对专业资源制作进行了优化。

功能特点

高分辨率输出：支持 1K、2K 和 4K 分辨率

高级文字渲染：能够生成清晰易读的风格化文字

Google 搜索接地：可使用 Google 搜索验证事实并根据实时数据生成图像

思考模式：模型会利用"思考"过程来推理复杂的提示

最多 14 张参考图片：支持混合使用多张参考图片

参考图片限制

最多 6 张高保真对象图片

最多 5 张人像照片（用于保持角色一致性）

总共最多 14 张图片

使用场景

专业资源制作

复杂的多轮创建和修改任务

信息图表、菜单、图表和营销素材

基于实时数据的图片生成

请求参数

Authorization

API Key

在 header 添加参数

x-goog-api-key

示例：

x-goog-api-key: ********************

Body 参数application/json必填

生成教育性信息图表

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "Create a vibrant infographic that explains photosynthesis as if it were a recipe for a plants favorite food. Show the 'ingredients' (sunlight, water, CO2) and the 'finished dish' (sugar/energy). The style should be like a page from a colorful kids cookbook, suitable for a 4th grader."
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "TEXT",
            "IMAGE"
        ]
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1beta/models/gemini-3-pro-image-preview:generateContent' \
--header 'x-goog-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "Create a vibrant infographic that explains photosynthesis as if it were a recipe for a plants favorite food. Show the '\''ingredients'\'' (sunlight, water, CO2) and the '\''finished dish'\'' (sugar/energy). The style should be like a page from a colorful kids cookbook, suitable for a 4th grader."
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "TEXT",
            "IMAGE"
        ]
    }
}'

返回响应

🟢200

application/json

成功生成内容

Bodyapplication/json

示例

{
    "candidates": [
        {
            "content": {
                "role": "user",
                "parts": [
                    {
                        "text": "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme",
                        "inline_data": {
                            "mime_type": "image/jpeg",
                            "data": "<BASE64_IMAGE_DATA>"
                        },
                        "thought": true,
                        "thought_signature": "string"
                    }
                ]
            },
            "finishReason": "STOP",
            "safetyRatings": [
                {
                    "category": "HARM_CATEGORY_HARASSMENT",
                    "probability": "NEGLIGIBLE"
                }
            ]
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 100,
        "candidatesTokenCount": 1290,
        "totalTokenCount": 1390
    },
    "groundingMetadata": {
        "searchEntryPoint": {
            "renderedContent": "string"
        },
        "groundingChunks": [
            {
                "web": {
                    "uri": "https://example.com/article",
                    "title": "Example Article Title"
                }
            }
        ]
    }
}

🟠400

🟠401

🟠429

🔴500

修改于 2025-12-29 09:13:52

使用 Gemini 2.5 Flash Image 生成内容

Chat 格式生成图片