Function Calling with the Gemini API

POST

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

Function calling lets you connect models to external tools and APIs. Instead of generating text responses, the model understands when to call specific functions and provides the necessary parameters to execute real-world actions. This allows the model to act as a bridge between natural language and real-world actions and data. Function calling has 3 primary use cases:

Augment Knowledge: Access information from external sources like databases, APIs, and knowledge bases.

Extend Capabilities: Use external tools to perform computations and extend the limitations of the model, such as using a calculator or creating charts.

Take Actions: Interact with external systems using APIs, such as scheduling appointments, creating invoices, sending emails, or controlling smart home devices

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": "What'\''s the temperature in London?"
          }
        ]
      }
    ],
    "tools": [
      {
        "functionDeclarations": [
          {
            "name": "get_current_temperature",
            "description": "Gets the current temperature for a given location.",
            "parameters": {
              "type": "object",
              "properties": {
                "location": {
                  "type": "string",
                  "description": "The city name, e.g. San Francisco"
                }
              },
              "required": ["location"]
            }
          }
        ]
      }
    ]
  }'

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

optional

parts

array [object {1}]

optional

tools

array [object {1}]

required

functionDeclarations

array [object {3}]

optional

Examples

Responses

🟢200成功

application/json

Body

object {0}

Set budget on thinking models

All Model