https://api.apexrouter.top/v1beta/models/{model}:generateContent

"""
知能API Gemini API 工具调用示例 - Google 搜索联网功能

本示例演示如何使用 Gemini API 的工具调用功能，
让模型通过 Google 搜索获取实时信息并生成回答。

工具：Google Search
"""

import os
from google import genai
from google.genai import types

# ============================================================
# 配置部分
# ============================================================

# 从环境变量读取 知能API 密钥，如果未设置则使用默认值
api_key = os.getenv("GEMINI_API_KEY", "sk-*******************************************")

# 从环境变量读取 知能API 基础 URL
BASE_URL = os.getenv("GEMINI_API_BASE_URL", "https://www.apexrouter.top")

# 创建 Gemini 客户端实例
client = genai.Client(
    api_key=api_key,
    http_options={'base_url': BASE_URL}
)

# ============================================================
# 工具配置
# ============================================================

# 配置 Google 搜索工具
# 该工具允许模型通过 Google 搜索获取实时信息
grounding_tool = types.Tool(
    google_search=types.GoogleSearch()
)

# 生成内容配置
# 将 Google 搜索工具添加到配置中
config = types.GenerateContentConfig(
    tools=[grounding_tool]
)

# ============================================================
# 执行查询
# ============================================================

# 调用 Gemini API 生成内容
# model: 使用 gemini-2.5-flash 模型
# contents: 用户的问题（查询上海天气）
# config: 包含 Google 搜索工具的配置
response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="今天上海的天气怎么样?",
    config=config,
)

# ============================================================
# 输出结果
# ============================================================

# 打印模型生成的回答
# 模型会先通过 Google 搜索获取实时天气信息，然后生成回答
print(response.text)

今天（2025年11月20日）上海天气晴朗，气温在7°C到15°C之间。

具体天气情况如下：
*   **当前**: 部分多云，气温11°C，体感温度11°C，湿度约为47%。
*   **今天白天**: 晴朗。
*   **今晚**: 晴朗，有5%的降雨概率。
*   **风力**: 西北风3-4级。
*   **空气质量**: 良好到轻度污染，首要污染物为PM2.5。

未来几天的天气预报：
*   **11月21日（周五）**: 晴朗，气温7°C到16°C，西北风3-4级。
*   **11月22日（周六）**: 白天晴朗，夜间晴转局部多云，气温10°C到17°C，有5%的降雨概率。
*   **11月23日（周日）**: 白天大部分晴朗，夜间大部分多云，气温11°C到20°C，夜间有10%的降雨概率。