Multi-turn conversations

POST

https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent

The Gemini SDK lets you collect multiple rounds of questions and responses into a chat. The chat format enables users to step incrementally toward answers and to get help with multipart problems. This SDK implementation of chat provides an interface to keep track of conversation history, but behind the scenes it uses the same generateContent method to create the response.

The following code example shows a basic chat implementation:

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=' \
--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?"
          }
        ]
      }
    ]
  }'

Response Example

{}

Request

Query Params

key

string

required

Example:

Header Params

Content-Type

string

required

Example:

application/json

Body Params application/json

contents

array [object {2}]

required

role

string

required

parts

array [object {1}]

required

Examples

Responses

🟢200成功

application/json

Body

object {0}

Modified at 2025-04-24 09:48:03

Streaming output

Multi-turn conversations (Streaming)