Gemini API 终极教程：5分钟快速掌握Python异步编程利器-平芜编程栈

Gemini API 终极教程：5分钟快速掌握Python异步编程利器

【免费下载链接】Gemini-API✨ An elegant async Python wrapper for Google Gemini web app项目地址: https://gitcode.com/gh_mirrors/gem/Gemini-API

Gemini API教程为您带来一款优雅的异步Python包装器，专为Google Gemini网页应用设计。无论您是Python API开发新手还是资深开发者，这份完整指南都将帮助您快速上手并充分发挥其强大功能。通过本教程，您将掌握如何利用这个免费工具构建高效的AI应用。

🚀 项目核心价值与快速部署

核心优势：

持久化Cookie管理- 后台自动刷新认证信息，完美适配持续运行服务
原生图像生成- 支持自然语言驱动的图片创建和编辑
智能系统提示- 通过Gemini Gems自定义模型行为
多扩展支持- 集成YouTube、Gmail等热门服务
官方风格接口- 提供简洁优雅的API设计

环境要求与一键安装

确保您的Python版本≥3.10，然后执行以下命令：

pip install -U gemini-webapi

可选增强功能：

pip install -U browser-cookie3

⚡ 快速配置技巧

认证配置捷径

专业提示：如果您已安装browser-cookie3，只需确保浏览器中已登录https://gemini.google.com，即可跳过手动认证步骤。

手动认证流程：

访问https://gemini.google.com并使用Google账户登录
按F12打开开发者工具，切换到Network标签页并刷新页面
复制任意请求中的__Secure-1PSID和__Secure-1PSIDTSCookie值

容器化部署最佳实践

在Docker环境中运行时，建议通过环境变量设置Cookie持久化路径：

services: main: environment: GEMINI_COOKIE_PATH: /tmp/gemini_webapi volumes: - ./gemini_cookies:/tmp/gemini_webapi

🔧 核心功能深度解析

智能对话管理

单轮对话示例：

import asyncio from gemini_webapi import GeminiClient async def main(): client = GeminiClient("YOUR_PSID", "YOUR_PSIDTS") await client.init() response = await client.generate_content("你好，Gemini！") print(response.text) asyncio.run(main())

多轮对话实现：

async def main(): chat = client.start_chat() # 第一轮对话 response1 = await chat.send_message("推荐一本科幻小说") print(response1.text) # 第二轮对话（保持上下文） response2 = await chat.send_message("详细介绍一下作者") print(response2.text)

文件处理与多模态交互

Gemini API支持多种文件格式输入，包括图片和文档：

async def main(): response = await client.generate_content( "分析这两个文件的内容关联性", files=["assets/sample.pdf", "assets/banner.png"] ) print(response.text)

📊 高级配置与优化策略

模型选择策略

当前可用模型（截至2025年12月）：

unspecified- 默认模型
gemini-3.0-pro- Gemini 3.0 Pro
gemini-2.5-pro- Gemini 2.5 Pro
gemini-2.5-flash- Gemini 2.5 Flash

from gemini_webapi.constants import Model async def main(): response = await client.generate_content( "你的模型版本是什么？仅回复版本号", model=Model.G_2_5_FLASH )

🛠️ 实用技巧与最佳实践

会话恢复机制

async def main(): # 开始新会话 chat = client.start_chat() response = await chat.send_message("今天天气不错") # 保存会话元数据 previous_session = chat.metadata # 恢复历史对话 previous_chat = client.start_chat(metadata=previous_session) response = await previous_chat.send_message("我刚才说了什么？") print(response.text)

图像生成与保存

async def main(): response = await client.generate_content("生成一些猫咪图片") for i, image in enumerate(response.images): await image.save(path="temp/", filename=f"cat_{i}.png") print(f"已保存图片：cat_{i}.png")