多轮对话

POST

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

请求参数

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 '/v1beta/models/gemini-3-flash-preview:generateContent' \
--header 'Authorization: sk-glYfYISQsZUOMOanXr37Ilbp0Ciz9B0KEHWiRpml55ORfhiX' \
--header 'Content-Type: application/json' \
--data '{
    "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

Bodyapplication/json

示例

{
    "candidates": [
        {
            "content": {
                "parts": [
                    {
                        "text": "There are **8 paws** in your house (assuming each dog has four paws).",
                        "thoughtSignature": "Ep0FCpoFAXLI2nz0ZLvcsMa834nIRgdOgmhRU/Dmp60uvRBO5xeMh/imGwN5lhL1Pbvurv77fhSFIe0/YTJG/NOJ8JOZVAVUHpH9oJy4mssR7qvxhzCSa8w73QTAlynHdpXqntBCtisMs7JMQvun+lVDYUpohequbwCM0TGU6s5PmScbjfVX3u7lymFb51Hs3DozKduTsy4d9VpcFWmTpxwzCX1UGHp+hYZabNrColyWmwX9pZigPUrurB6s2U40mYVWhYqwBc+vU8b6Dg+rTVxw3aRW23VY4V5dYSCoRSHmpYbF3dP0MHPj0cLDCwFPIRbJ1XkyH28k83mrTDOf/GocJIfAOrXmJy4hBYt9BxWyWFh7ZWxzQ4mjkOtzpvHJcc+KS0nwHGr/7ZsHwX9bts3BPGhAazmtdduLvX97zUWOdskv4iAHpNbs5BLhVdv5mT+bK+72VstfUN68nHjBUH2vQsz6H0GbYhq0VZlLwiqBXDrWHEIC7ySecu8zzti4BmKm8QHn4Lln27+6JqVqar457B6WIMX1lBo5XezGa3S2YquUDXbuc3N7c3ttuQi6KeSJpKuUKiPXk5P0dQix/6iaOQJdWFppNgv1++sX63i6FiHRIePL2Gx/kZpwqJmocmGaLIXvhcoeYYJoniriuAnA4qc4+tfbgHt+G3t77Phn+/qP+SKrkDHlcIXZMLEmoX9e6OMq0R1HtGb/h50RrBebVivSnXrS19Uuol1z3sN0k/ZIcgSNjafeTbmJDkBaR2InjYVA4Euc8tGF8YsNF8YjK0jHPjqBN8Fzvd3XgHIeIRC2eqU85xpHax0pXxeSAvU7oyUDlHervLvYzJcZK3f7/Z86n4VqyN3HsYouBG4AWMUIF5F8pUmbjzaV6et0"
                    }
                ],
                "role": "model"
            },
            "finishReason": "STOP",
            "index": 0
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 32,
        "candidatesTokenCount": 17,
        "totalTokenCount": 232,
        "promptTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 32
            }
        ],
        "thoughtsTokenCount": 183
    },
    "modelVersion": "gemini-3-flash-preview",
    "responseId": "TxR4adFJydOMxw-Mx9OgAg"
}

修改于 2026-04-28 14:58:35

流式响应

gemini格式聊天接口