Gemini 3.8 Flash (openai)

流式响应支持

当请求中设置 stream: true 时，API 将以服务器发送事件（SSE）的形式返回响应，Content-Type 为 text/event-stream。这允许渐进式响应交付，消息增量会在生成时逐步发送。每个事件包含部分消息内容，使您能够在应用程序中实时显示响应。

流式响应格式：

• Content-Type: text/event-stream
• 每个事件行以 data: 开头，后跟 JSON
• 事件包含增量消息增量
• 最终事件通过 finish_reason 指示完成
• 流的最后一块带 usage 与 credits_consumed，随后是 data: [DONE]。

支持文本、图像、视频、音频、PDF 输入 启用 Google 搜索增强 支持服务器发送事件 支持多种消息角色

统一媒体文件格式

Tools 参数

tools 参数是一个可选数组，允许您定义模型可以调用的函数。数组可以包含多个对象。使用函数调用时，可以在数组中定义多个函数。

定义带有参数的自定义函数。可以在 `tools` 数组中定义多个函数：

[
  {
    "type": "function",
    "function": {
      "name": "get_current_weather",
      "description": "获取给定位置的当前天气",
      "parameters": {
        "type": "object",
        "properties": {
          "location": {
            "type": "string",
            "description": "城市和州，例如：San Francisco, CA"
          },
          "unit": {
            "type": "string",
            "enum": ["celsius", "fahrenheit"]
          }
        },
        "required": ["location"]
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "get_stock_price",
      "description": "获取指定股票代码的当前股价",
      "parameters": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string",
            "description": "股票代码，例如：AAPL"
          }
        },
        "required": ["symbol"]
      }
    }
  }
]

函数声明要求

在提示中实现函数调用时，您需要创建一个 tools 数组，其中包含一个或多个函数声明。您可以使用 JSON（具体来说是 OpenAPI 架构格式的选定子集）来定义函数。

单个函数声明可以包含以下参数：

• name（字符串，必需）：函数的唯一名称（例如，get_weather_forecast、send_email）。使用不含空格或特殊字符的描述性名称（使用下划线或驼峰式命名法）。

• description（字符串，可选但推荐）：对函数用途和功能的清晰而详尽的说明。这对于模型了解何时使用函数至关重要。请具体说明，并在必要时提供示例（例如，"根据位置查找影院，还可以选择查找目前正在影院上映的电影。"）。

• parameters（对象，必需）：定义函数预期的输入参数。包含：

  • type（字符串）：指定总体数据类型，必须为 "object"。
  • properties（对象）：列出各个参数，每个参数都具有以下属性：
    • type（字符串）：参数的数据类型，例如 string、integer、boolean、array。
    • description（字符串）：对参数的用途和格式的说明。提供示例和限制条件（例如，"城市和州，例如'加利福尼亚州旧金山'或邮政编码（例如'95616'）。"）。
    • enum（数组，可选）：如果参数值来自固定集，请使用 enum 列出允许的值，而不是仅在说明中描述它们。这有助于提高准确性（例如，"enum": ["daylight", "cool", "warm"]）。
  • required（数组）：一个字符串数组，列出了函数运行所必需的参数名称。

错误响应

错误以 HTTP 200 返回，响应体为 {"code": , "msg": "<原因>"}。读取 choices/candidates 前请先判断 code（200 为成功）。