Google Colab与google-genai依赖冲突致Gemini 1.5 Flash持续404求助

核心解决方案 #

方案1：虚拟环境隔离依赖（推荐，不破坏Colab原生工具） #

通过创建独立虚拟环境安装所需版本的依赖，完全隔离系统级的google-colab包：

1. 安装虚拟环境工具

!pip install virtualenv

2. 创建并配置虚拟环境

!virtualenv venv
# 激活虚拟环境并安装指定版本的依赖
!source venv/bin/activate && pip install google-genai==0.3.0 google-auth==2.47.0

3. 在Colab中加载虚拟环境的包
   在代码开头添加以下内容，让Python优先加载虚拟环境中的依赖：

import sys
# 注意路径需匹配Colab的Python版本（当前Colab默认是3.10）
sys.path.insert(0, '/content/venv/lib/python3.10/site-packages')

4. 配置genai使用v1生产端点
   明确指定API端点避免路由到废弃的v1beta：

import google.generativeai as genai
genai.configure(api_key="你的Gemini API密钥", api_endpoint="https://generativelanguage.googleapis.com/v1")

5. 正确使用文件上传功能
   使用Colab原生的文件上传工具，避免与SDK的方法冲突：

from google.colab import files
uploaded = files.upload()
# 处理上传文件示例
for filename in uploaded.keys():
    print(f"已上传文件：{filename}")

方案2：强制安装兼容依赖（简洁但有轻微风险） #

如果不想用虚拟环境，可通过忽略依赖冲突的方式安装，尽量减少对Colab原生工具的影响：

1. 强制安装指定版本的依赖

# 不安装google-genai的依赖，避免触发版本冲突
!pip install google-genai==0.3.0 --no-deps
# 强制替换google-auth版本，不安装其依赖
!pip install google-auth==2.47.0 --force-reinstall --no-deps

2. 重启运行时后，执行方案1中的步骤4和步骤5即可。

问题原因说明 #

• 依赖冲突：Colab的google-colab包硬依赖google-auth==2.43.0，直接升级google-auth会触发版本不兼容提示，虚拟环境隔离可彻底解决此问题。
• API端点404：旧版SDK默认使用v1beta端点，而gemini-1.5-flash仅在正式v1端点可用，需手动指定api_endpoint切换。
• Files.upload()语法错误：混淆了google-genai的内部上传方法与Colab原生的files.upload()，后者不需要file参数，直接调用即可。

内容的提问来源于stack exchange，提问作者Alonso