python-genai

环境要求

• Python 环境（能运行 pip 即可，本项目为纯 Python 库）
• 有效的 Gemini API Key（使用 Gemini Developer API 时必备）
• 使用 Agent Platform 时需具备 GCP 项目 ID 与可用区域（location）
• 如需使用 MCP 工具，需额外安装 mcp 包

安装与启动步骤

1. 1安装 SDK

   在 Python 环境中用 pip 安装官方库 google-genai；用 uv 管理环境时可用 uv pip 安装

   pip install google-genai

   复制

2. 2准备 API Key

   使用 Gemini Developer API 时需准备 API Key，后续以 api_key 参数传给客户端

3. 3初始化客户端

   导入 genai 后创建 Client，Developer API 传 api_key，企业平台传 enterprise、project、location

   from google import genai
   
   # Only run this block for Gemini Developer API
   client = genai.Client(api_key='GEMINI_API_KEY')

   复制

4. 4使用 Agent Platform

   如走 Gemini 企业/代理平台，改用 enterprise=True 并填写项目 ID 与区域，不再传 api_key

   from google import genai
   
   # Only run this block for Agent Platform
   client = genai.Client(
       enterprise=True, project='your-project-id', location='global'
   )

   复制

5. 5安装 MCP 依赖

   只有在 Agent Platform 上使用 MCP 服务器工具时才需要安装 mcp 包

   pip install mcp

   复制

6. 6运行调用示例

   在 generate_content 的 tools 里放入 McpServer 并异步调用，最后 asyncio.run 启动事件循环

   import asyncio
   from google import genai
   from google.genai import types
   
   PROJECT_ID="your-gcp-project"
   LOCATION="your-location"
   
   client = genai.Client(enterprise=True, project=PROJECT_ID, location=LOCATION)
   
   
   async def agent_platform_mcp():
       response = await client.aio.models.generate_content(
           model="gemini-flash-latest",
           contents=f"List my endpoints in {LOCATION} for my {PROJECT_ID} project.",
           config = types.GenerateContentConfig(
               tools=[
                   types.Tool(
                       mcp_servers=[
                           types.McpServer(name='endpoints')
                       ]
                   )
               ]
           )
       )
   
       if response.text:
           print(response.text)
   
   asyncio.run(agent_platform_mcp())

   复制

关键配置

如何确认成功

运行示例脚本不报错，且打印出模型返回的文本（response.text）即为成功。

常见问题

注意事项

• 下个主要版本会调整自动函数调用（AFC）：Models.generate_content 将不再支持直接触发 AFC，需改用 Chats 模块。
• Live.send、Live.start_stream、LiveConnectConfig.generation_config 等接口将被移除，新代码请使用替代方法。
• generate_videos 的 prompt/text/image 参数将改为 source 参数，GenerationConfigThinkingConfig 将改为 ThinkingConfig。
• 为避免意外升级影响线上服务，建议将 google-genai 版本锁定在 3.0.0 以下。