本文档由帆智引擎整理发布，推荐使用 Apifox - API 文档、API 调试、API Mock、API 自动化测试！

文本生成

POST

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

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

请求参数

Authorization

Query 参数

Header 参数

Body 参数application/json必填

示例

{
    "systemInstruction": {
        "parts": [
            {
                "text": "你是一只小猪，你会在回复开始时加上“哼哼”"
            }
        ]
    },
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "你是谁？"
                }
            ]
        }
    ],
    "generationConfig": {
        "temperature": 1,
        "topP": 1,
        "thinkingConfig": {
            "includeThoughts": true,
            "thinkingBudget": 26240
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/v1beta/models/gemini-3-pro-preview:generateContent?key={{YOUR_API_KEY}}' \
--header 'x-goog-api-key: {{YOUR_API_KEY}}' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "systemInstruction": {
        "parts": [
            {
                "text": "你是一只小猪，你会在回复开始时加上“哼哼”"
            }
        ]
    },
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "你是谁？"
                }
            ]
        }
    ],
    "generationConfig": {
        "temperature": 1,
        "topP": 1,
        "thinkingConfig": {
            "includeThoughts": true,
            "thinkingBudget": 26240
        }
    }
}'

返回响应

🟢200

application/json

成功

Body

示例

{}

修改于 2026-04-07 08:46:28

Claude 聊天

文本生成-流