deprecated-generative-ai-python
Google Gemini Python SDK 官方封装库（已废弃），提供文本生成、多模态理解、函数调用等能力，已停止维护，建议迁移至统一 SDK。
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
Google Gemini Python SDK 官方封装库（已废弃），提供文本生成、多模态理解、函数调用等能力，已停止维护，建议迁移至统一 SDK。
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
2022 年，Google 为 Gemini 模型推出专属 Python 开发工具包（SDK）——google-generativeai。彼时，Gemini 模型刚刚出道，Google 需要一套易用的封装，让 Python 开发者无需直面底层 REST API 的繁琐细节，就能完成文本生成、多模态理解、函数调用等能力。
三年后的今天，这把钥匙已被 Google 主动收回——Gemini 2.0 发布时，Google 决定将所有 AI 产品（Gemini、Veo 视频生成、Imagen 图片生成）统一到同一个 SDK 中，google-generativeai 正式宣布废弃，2025 年 11 月 30 日停止所有支持。
第一层：API 客户端（client.py / models.py）——负责与 Google Gemini REST API 的通信，基于 google-api-core 和 google-auth 构建，支持 API Key 和 OAuth 两种认证方式。SDK 将 Python 对象序列化为 Protobuf，再通过 HTTP POST 发送到 Google 服务器。
第二层：类型系统（types/ 目录）——用 Pydantic 定义所有数据结构（生成配置、安全过滤、内容对象、权限设置等），让 IDE 拥有完整的类型提示和自动补全。
第三层：高层封装（generative_models.py / answer.py / embedding.py）——提供了比裸 API 更友好的接口。GenerativeModel 类封装了完整的对话流程，generate_content() 一行代码完成一次生成，stream_generate_content() 完成流式生成。
model.generate_content("写一首关于AI的诗")chat = model.start_chat(); chat.send_message("你好")这是一个纯 Python 库，不是可以直接运行的服务。部署它的本质是"在项目中引入它"。
| 维度 | 评估 |
|---|---|
| 容器化 | ❌ 无 Dockerfile / docker-compose |
| Web UI | ❌ 无界面，纯 Python API 调用库 |
| 硬件需求 | 极低，无需 GPU，仅需 Python 3.9+ |
| 安装方式 | pip install google-generativeai |
| 运行要求 | 需要 Google Gemini API Key（GOOGLE_API_KEY 环境变量） |
整个 SDK 不具备独立部署价值——必须依托 Google 的 Gemini API 服务才能工作。
2024 年 12 月 Google 发布 Gemini 2.0 时，做了战略决策：将所有生成式 AI 产品统一到同一个 SDK。理由是开发者体验碎片化（之前各产品各自为政）、统一认证体系需求，以及 API 协议升级带来的 breaking change。
仅接受关键 Bug 修复，不新增任何功能，所有支持于 2025 年 11 月 30 日彻底终止。
google-generativeai 是一个典型的AI SDK 生命周期样本：快速推出 → 开发者采用 → 产品整合 → 战略废弃。2,329 颗 GitHub stars 记录了过去两年间大量开发者的使用痕迹。
它还揭示了一个趋势：AI 基础设施正在走向平台整合。随着多模态 AI（文本+视频+图片+代码）成为标配，单一模型 SDK 的生命周期正在缩短，统一 SDK 将成为行业主流。
对于仍在使用该 SDK 的项目，强烈建议尽快迁移至 googleapis/python-genai——新 SDK 不只是功能超集，还将在未来持续获得新能力更新和技术支持。