Gemini generateContent（非流式）

POST

/v1beta/models/{model}:generateContent

Gemini 原生格式的非流式内容生成接口。

支持Gemini原生请求的模型：

gemini-2.0-flash

gemini-2.5-flash-preview-05-20

gemini-2.5-pro-preview-05-06

gemini-3-flash-preview

gemini-3-pro-preview

gemini-3.1-pro-preview

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

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Body 参数application/json必填

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "你好，你是谁？"
                }
            ]
        }
    ],
    "generationConfig": {
        "temperature": 1,
        "maxOutputTokens": 2048
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1beta/models/:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "你好，你是谁？"
                }
            ]
        }
    ],
    "generationConfig": {
        "temperature": 1,
        "maxOutputTokens": 2048
    }
}'

返回响应

🟢200

application/json

成功

Body

示例

{
    "candidates": [
        {
            "content": {
                "parts": [
                    {
                        "text": "你好！我是 Gemini，由 Google 开发的大型语言模型。有什么可以帮助你的吗？"
                    }
                ],
                "role": "model"
            },
            "finishReason": "STOP",
            "safetyRatings": [
                {
                    "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
                    "probability": "NEGLIGIBLE"
                },
                {
                    "category": "HARM_CATEGORY_HATE_SPEECH",
                    "probability": "NEGLIGIBLE"
                },
                {
                    "category": "HARM_CATEGORY_HARASSMENT",
                    "probability": "NEGLIGIBLE"
                },
                {
                    "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
                    "probability": "NEGLIGIBLE"
                }
            ]
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 5,
        "candidatesTokenCount": 28,
        "totalTokenCount": 33
    },
    "modelVersion": "gemini-2.5-flash-preview-05-20"
}

修改于 2026-03-29 08:41:22

WONDER AI API

Gemini streamGenerateContent（流式）