快速上手Gemini API项目教程：5分钟搞定Python异步AI开发

快速上手Gemini API项目教程：5分钟搞定Python异步AI开发

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

想要快速上手Google Gemini API项目开发吗？这篇完整的Gemini API项目教程将带你从零开始，只需5分钟就能掌握这个优雅的异步Python包装器。无论你是AI开发新手还是经验丰富的开发者，本文都将为你提供清晰的项目结构解析和实用的配置指南。

🚀 项目概览与核心功能

Gemini-API是一个反向工程的异步Python包装器，专门为Google Gemini Web应用设计。它采用现代化的异步架构，让你的AI应用开发更加高效流畅。

核心亮点功能：

• 🍪持久化Cookie管理- 自动在后台刷新Cookie，专为持续运行的服务优化
• 🎨原生图像生成- 支持自然语言生成和编辑图像
• 💎系统提示定制- 通过Gemini Gems自定义模型的系统提示
• 🔌扩展支持- 支持YouTube、Gmail等Gemini扩展功能
• 🧠思维过程追踪- 可检索模型的思考过程（适用于具备思考能力的模型）

📁 项目结构深度解析

了解项目结构是快速上手的第一步。Gemini-API采用清晰的模块化设计：

src/gemini_webapi/ ├── components/ # 核心组件模块 │ ├── gem_mixin.py # Gem混合功能 ├── types/ # 数据类型定义 │ ├── candidate.py # 回复候选类型 │ ├── gem.py # Gem类型定义 │ └── modeloutput.py # 模型输出类型 ├── utils/ # 工具函数集合 │ ├── get_access_token.py # 访问令牌获取 │ └── rotate_1psidts.py # Cookie轮转

⚡ 安装与环境配置

基础安装步骤

安装过程非常简单，只需一条命令：

pip install -U gemini_webapi

系统要求：

• Python 3.10或更高版本
• 支持异步编程的现代Python环境

可选功能增强

如果需要从本地浏览器自动导入Cookie，可以额外安装：

pip install -U browser-cookie3

🔐 认证配置指南

获取认证Cookie

1. 访问 https://gemini.google.com 并登录Google账户
2. 按F12打开开发者工具，切换到Network标签页
3. 刷新页面后点击任意请求，复制以下Cookie值：
   • __Secure-1PSID
   • __Secure-1PSIDTS

容器化部署建议

对于Docker等容器化环境，建议设置Cookie持久化：

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

💡 实战使用技巧

基础内容生成

最简单的使用方式就是单轮对话：

response = await client.generate_content("Hello World!") print(response.text)

文件处理功能

Gemini支持图像和文档文件输入，你可以：

response = await client.generate_content( "分析这两个文件的内容", files=["assets/sample.pdf", "assets/banner.png"] )

多轮对话管理

保持对话连续性的正确方式：

chat = client.start_chat() response1 = await chat.send_message("第一个问题") response2 = await chat.send_message("基于刚才的回答继续提问")

🛠️ 高级功能探索

模型选择与切换

你可以根据需要选择不同的语言模型：

• gemini-3.0-pro- Gemini 3.0 Pro版本
• gemini-2.5-pro- Gemini 2.5 Pro版本
• gemini-2.5-flash- Gemini 2.5 Flash版本

Gem系统提示定制

通过Gemini Gems为对话应用系统提示：

# 获取所有可用的Gems await client.fetch_gems() # 使用特定的Gem coding_partner = client.gems.get(id="coding-partner") response = await client.generate_content( "你的系统提示是什么？", gem=coding_partner )

图像生成与编辑

利用Nano Banana模型生成和编辑图像：

response = await client.generate_content("生成一些猫咪的图片") for i, image in enumerate(response.images): await image.save(path="temp/", filename=f"cat_{i}.png")

🎯 最佳实践建议

资源管理优化

在持续运行的服务中，建议启用自动关闭功能：

await client.init(auto_close=True, close_delay=300)

日志配置

使用loguru进行日志管理：

from gemini_webapi import set_log_level set_log_level("DEBUG")

📈 项目优势总结

通过这篇Gemini API项目教程，你已经掌握了：

✅快速安装配置- 简单的pip安装和Cookie认证 ✅项目结构理解- 清晰的模块化设计便于维护 ✅核心功能使用- 从基础对话到高级图像生成 ✅最佳实践指南- 资源管理和日志配置优化

现在你已经具备了使用Gemini-API进行AI应用开发的所有基础知识。这个优雅的异步Python包装器将大大提升你的开发效率，让你能够专注于业务逻辑而不是底层实现细节。

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