gemini-webapi · PyPI

简介

gemini-webapi 是一个基于 Python 的异步封装库，旨在为开发者提供简洁、高效的方式与谷歌 Gemini 大语言模型进行交互。通过该库，您可以轻松调用 Gemini 的原生 Web API，快速构建智能对话、内容生成、代码辅助等应用场景。本库专注于异步支持，确保在高并发或 I/O 密集型任务中依然保持出色的性能表现。

主要功能

• 异步调用支持：基于 asyncio 和 aiohttp 实现，完美融入现代 Python 异步生态。
• 多模态交互：支持文本、图片、音频等多种输入格式，充分发挥 Gemini 的多模态理解能力。
• 流式响应：内置流式输出支持，让您实时获取生成结果，提升用户体验。
• 对话管理：提供简单的会话上下文管理，方便实现多轮对话与记忆功能。
• 错误重试与超时控制：内置智能重试机制和可配置超时策略，提高调用稳定性。
• 轻量无依赖：核心依赖极少，安装简单，几乎零配置即可上手。

特色优势

gemini-webapi 的最大特色在于其纯粹的异步架构。与传统的同步封装不同，本库从底层设计上拥抱异步编程模型，让您在处理大量并发请求时无需担心线程阻塞或资源浪费。此外，库的接口设计高度 Pythonic，函数命名直观，文档齐全，即使是异步编程的初学者也能快速掌握。相比于官方 SDK 或其他第三方封装，gemini-webapi 在保持功能完整性的同时，大幅降低了集成复杂度。

适用人群

• Python 开发者：希望快速集成 Gemini 能力到现有异步项目（如 FastAPI、Sanic、Tornado）中的开发者。
• AI 应用构建者：正在搭建聊天机器人、内容生成工具、智能助手等产品的技术人员。
• 研究与教育人员：需要批量测试或分析 Gemini 模型输出的研究人员，以及教授异步编程与 AI 结合的教学者。
• 技术爱好者：对谷歌 Gemini 模型感兴趣，希望用 Python 进行实验性开发的学习者。

常见问题

问：gemini-webapi 需要谷歌 API 密钥吗？
答：是的，使用本库需要您拥有有效的谷歌 Gemini API 密钥。您可以在谷歌 AI Studio 或云控制台中获取。

问：该库是否支持同步调用？
答：本库专注于异步实现，不提供同步接口。如果您需要同步调用，建议使用官方 SDK 或其他同步封装库。

问：如何安装 gemini-webapi？
答：直接通过 pip 安装即可：pip install gemini-webapi。安装后即可在 Python 3.8+ 环境中使用。

问：是否支持自定义模型参数？
答：支持。您可以在调用时自由设置 temperature、top_p、max_output_tokens 等常见参数，以控制生成结果的风格和长度。

问：遇到网络错误或超时怎么办？
答：库内置了自动重试机制，默认会尝试 3 次。您也可以通过参数调整重试次数和超时时间，以适应不同的网络环境。