文本对话（优先） / 生成图像（Nano Banana）

POST

/v1beta/models/{model}:generateContent

文本对话（优先）

谷歌Gemini API 请求
路径格式: /v1beta/models/{model_name}:{action}
可选模型ID例如：

gemini-2.5-flash

gemini-2.5-pro

gemini-3-flash-preview

gemini-3.1-pro-preview等等

生成图像（Nano Banana）

谷歌Gemini API 请求
路径格式: /v1beta/models/{model_name}:{action}
可选模型ID例如：

gemini-2.5-flash-image（Nano Banana）

gemini-3.1-flash-image-preview（Nano Banana 2）

gemini-3-pro-image-preview（Nano Banana Pro）

请求参数

Path 参数

Body 参数application/json必填

示例

文本对话（优先）-示例 1生成图像（Nano Banana）-文生图生成图像（Nano Banana）-图生图

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "hello"
                }
            ]
        }
    ],
    "generationConfig": {
        "maxOutputTokens": 100
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

文本对话（优先）-示例 1生成图像（Nano Banana）-文生图生成图像（Nano Banana）-图生图

curl --location '/v1beta/models/gemini-2.5-flash:generateContent' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "hello"
                }
            ]
        }
    ],
    "generationConfig": {
        "maxOutputTokens": 100
    }
}'

返回响应

🟢200

application/json

成功

Bodyapplication/json

示例

文本对话（优先）-成功示例生成图像（Nano Banana）-成功示例

{
    "candidates": [
        {
            "content": {
                "parts": [
                    {
                        "text": "Hello! How can I help you today?"
                    }
                ],
                "role": "model"
            },
            "finishReason": "STOP"
        }
    ],
    "createTime": "2026-02-02T08:14:42.379547Z",
    "modelVersion": "gemini-2.5-flash",
    "responseId": "8lyAaZuVF5apmecPvtugMA",
    "usageMetadata": {
        "candidatesTokenCount": 9,
        "candidatesTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 9
            }
        ],
        "promptTokenCount": 1,
        "promptTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 1
            }
        ],
        "thoughtsTokenCount": 22,
        "totalTokenCount": 32,
        "trafficType": "ON_DEMAND"
    }
}

修改于 2026-06-01 06:20:57

获取视频内容

创建视频（文生视频） / 创建视频（首帧图-图生视频） / 创建视频（参考图-图生视频） / 创建视频（编辑视频） / 创建视频（首帧-图生视频） / 创建视频（首尾帧-图生视频） / 创建视频（多模态-参考生视频）

文本对话（优先） / 生成图像（Nano Banana）