Google Gemini 1.5 Flash模型404错误及SSL连接异常排查求助

阿华AIGC实验室

2026-4-2

一、先搞定核心的404模型找不到问题

这个问题我前阵子帮同事排查过，核心原因是模型版本和API版本不匹配：

Gemini 1.5 Flash系列模型是在Google Generative AI的v1正式版API里上线的，而你的代码现在默认调用的是v1beta测试版本——这个beta版本已经不再支持1.5系列模型了，所以才会报404。

解决步骤：

强制指定API版本为v1
在初始化的时候，明确指定使用v1版本的API，两种方式二选一：

import google.generativeai as genai

genai.configure(api_key="MY_API_KEY")
# 方式1：设置默认API版本
genai.set_defaults(api_version="v1")

# 方式2：直接指定API端点
# genai.configure(api_key="MY_API_KEY", client_options={"api_endpoint": "https://generativelanguage.googleapis.com/v1"})

# 现在再初始化模型就没问题了
model = genai.GenerativeModel("gemini-1.5-flash")
response = model.generate_content("Test prompt")
print(response.text)

正确检查可用模型
你之前用genai.list_models()但没遍历，其实可以这样打印所有支持generateContent的可用模型，确认1.5 Flash的准确名称：
```
import google.generativeai as genai
genai.configure(api_key="MY_API_KEY", api_version="v1")

for model in genai.list_models():
    if "generateContent" in model.supported_generation_methods:
        print(f"可用模型：{model.name}")
```
现在1.5 Flash的标准名称是models/gemini-1.5-flash-001，不过用gemini-1.5-flash作为别名也能正常识别。
关于API配额的疑问
配额耗尽的错误提示是QuotaExceeded，不是404，所以这个问题和配额没关系，你可以直接排除这个可能性。

二、SSL连接警告/错误的处理

这些SSL错误和404是两个独立问题，不会直接导致模型404，但会影响API调用的稳定性，得顺手解决：

可能的原因：

本地代理工具干扰：比如你开了翻墙工具、公司内网代理，这些代理会篡改SSL握手包，导致版本不匹配或者解密失败。
系统SSL证书库异常：本地的根证书过期或者缺失，导致无法验证Google API的HTTPS证书。
Flask本地服务器的HTTP/HTTPS混淆：你的Flask跑在HTTP的本地服务，但调用Google API是HTTPS，不过这个本身不会导致SSL错误，主要还是前两个原因。

解决建议：

先关掉所有本地代理工具（比如Clash、V2Ray之类的），重启Flask再测，大概率能解决SSL警告。

如果是公司内网必须用代理，得给google.generativeai配置代理：

import os
os.environ["HTTP_PROXY"] = "http://你的代理地址:端口"
os.environ["HTTPS_PROXY"] = "http://你的代理地址:端口"

# 然后再初始化genai
import google.generativeai as genai
genai.configure(api_key="MY_API_KEY", api_version="v1")

更新系统的SSL证书：比如在Ubuntu/Debian上跑sudo apt update && sudo apt install --reinstall ca-certificates，Windows上可以通过「Internet选项」的证书管理器更新根证书。
那个启动时的超时错误，是工具类在检查API可用性时的超时，只要后续调用模型正常，暂时不影响，但解决SSL问题后这个错误也会消失。