使用 Gemini API 进行函数调用

开发中

正式环境

https://generativelanguage.googleapis.com

POST

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

借助函数调用，您可以将模型连接到外部工具和 API。该模型不会生成文本回答，而是会了解何时调用特定函数，并提供执行实际操作所需的参数。这样，模型就可以充当自然语言与现实世界操作和数据之间的桥梁。函数调用有 3 种主要用例：

扩充知识：访问数据库、API 和知识库等外部来源中的信息。

扩展功能：使用外部工具执行计算，并扩展模型的限制，例如使用计算器或创建图表。

执行操作：使用 API 与外部系统互动，例如安排预约、创建账单、发送电子邮件或控制智能家居设备

请求示例

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"]
            }
          }
        ]
      }
    ]
  }'

响应示例

{}

请求参数

Query 参数

key

string

必需

示例值:

Header 参数

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

contents

array [object {2}]

必需

role

string

可选

parts

array [object {1}]

可选

tools

array [object {1}]

必需

functionDeclarations

array [object {3}]

可选

示例

返回响应

🟢200成功

application/json

Body

object {0}

为思考模型设置预算

所有模型