普通对话

POST

{{url}}/v1beta/models/gemini-2.5-flash:generateContent

最后修改时间：2025-11-29 14:35:35

请求参数

Query 参数

Header 参数

Body 参数application/json

示例

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "Hello"
                }
            ]
        },
        {
            "role": "model",
            "parts": [
                {
                    "text": "Great to meet you. What would you like to know?"
                }
            ]
        },
        {
            "role": "user",
            "parts": [
                {
                    "text": "I have two dogs in my house. How many paws are in my house?"
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://api.example.com/v1beta/models/gemini-2.5-flash:generateContent?key=sk-xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "Hello"
                }
            ]
        },
        {
            "role": "model",
            "parts": [
                {
                    "text": "Great to meet you. What would you like to know?"
                }
            ]
        },
        {
            "role": "user",
            "parts": [
                {
                    "text": "I have two dogs in my house. How many paws are in my house?"
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "candidates": [
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "text": "That's an easy one!\n\nEach dog has 4 paws, so with two dogs, you have **8 paws** in your house."
                    }
                ]
            },
            "finishReason": "STOP",
            "avgLogprobs": -0.788928731282552
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 29,
        "candidatesTokenCount": 30,
        "totalTokenCount": 165,
        "trafficType": "ON_DEMAND",
        "promptTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 29
            }
        ],
        "candidatesTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 30
            }
        ],
        "thoughtsTokenCount": 106
    },
    "modelVersion": "gemini-2.5-flash",
    "createTime": "2025-11-29T14:35:38.738265Z",
    "responseId": "ugQradmHLcLJ4_UP1bqJ-AU"
}

修改于 2025-11-29 14:35:35

Gemini 生成音频(TTS)

开启思考