Routescope APIRoutescope API

工具调用

gemini-3-1-pro-preview-customtools 工具调用接口

路径中的 model 使用 gemini-3.1-pro-preview-customtools。

通过 tools 字段定义函数声明，模型可根据用户输入自动决定是否调用工具。

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "北京今天天气怎么样？"
        }
      ]
    }
  ],
  "tools": [
    {
      "functionDeclarations": [
        {
          "name": "get_weather",
          "description": "查询指定城市的天气信息",
          "parameters": {
            "type": "object",
            "properties": {
              "city": {
                "type": "string",
                "description": "城市名称"
              }
            },
            "required": ["city"]
          }
        }
      ]
    }
  ]
}
POST
/v1beta/models/{model}:generateContent
curl -X POST "https://api.routescope.ai/v1beta/models/gemini-3.1-pro-preview-customtools:generateContent" \  -H "Content-Type: application/json" \  -d '{    "contents": [      {        "parts": [          {            "text": "写一首四句的中文短诗，主题是城市夜雨。"          }        ]      }    ],    "generationConfig": {      "temperature": 0.7,      "maxOutputTokens": 100000    }  }'
{
  "candidates": [],
  "usageMetadata": {},
  "modelVersion": "string"
}

Authorization

BearerAuth

AuthorizationBearer <token>

模型 relay 接口鉴权。请求头：Authorization: Bearer 。

In: header

Path Parameters

model*string

Gemini 模型名。

Default"gemini-3.1-pro-preview-customtools"

Request Body

application/json

contents?

输入内容数组，用于承载用户、模型或工具之间的一轮或多轮消息。每个元素是一个 Content 对象，通常包含 role 与 parts：role 表示消息来源，常用 user、model，单轮用户输入可省略；parts 是内容片段数组，可包含 text 文本、inlineData/inline_data Base64 媒体数据（需提供 mime_type 与 data）、functionCall、functionResponse、executableCode 或 codeExecutionResult。适用于文本对话、图片/音频/视频/文档理解、函数调用和多模态生成等场景。数组长度及媒体大小以上游模型和业务配置限制为准。

systemInstruction?object

Gemini 系统指令。

generationConfig?

生成配置，例如温度、topK、topP、最大输出长度。

safetySettings?

安全策略设置。 safetySettings 列表。范围：数组长度以上游或业务配置为准。

tools?

Gemini 工具定义。 工具定义列表。范围：数组长度和 schema 复杂度以上游限制为准。

Response Body

application/json

最后更新于