在notebook中切换gemini api模型需直接控制请求体model字段:①安装导入google-generativeai;②用api key配置sdk;③创建模型时显式传入完整id如"gemini-3.1-pro";④通过响应头x-model-id验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Notebook中快速切换不同版本的Gemini API接口模型,需绕过前端界面限制,直接控制请求体中的model字段并确保认证与路由正确生效;不修改请求参数将始终调用默认模型,无法触发版本切换。
通过requests库手动指定model参数
这是最直接、最可控的方式,适用于Jupyter或Colab等Python Notebook环境,无需依赖任何UI组件。
第一步:安装并导入必要库——若尚未安装google-generativeai,运行!pip install google-generativeai;然后执行import google.generativeai as genai。
第二步:用genai.configure(api_key="YOUR_API_KEY")初始化SDK,注意【API Key必须具备调用目标模型的权限,例如gemini-3.1-pro需对应已开通的高级配额】。
第三步:创建模型实例时显式传入完整模型ID,例如model = genai.GenerativeModel("gemini-3.1-pro");不要使用"gemini-pro"这类模糊别名,否则会回退到网关默认路由。
第四步:调用model.generate_content(...)发起请求,响应头中X-Model-ID字段将明确返回实际执行模型,可用于验证是否切换成功。
用One-API网关代理实现多模型共存
当本地Notebook需同时对比多个Gemini版本输出,且不希望反复修改代码中的model字符串时,推荐部署One-API作为统一代理层。
方法一:通过URL路径区分模型
向http://your-oneapi-host/v1/chat/completions发送POST请求,在请求体JSON中写入{"model": "gemini-2.5-pro-preview-03-21", "messages": [...]};One-API会自动将该字段映射至对应Gemini后端地址。
方法二:用查询参数强制路由
构造请求URL为http://your-oneapi-host/v1/chat/completions?model=gemini-1.5-flash-latest,此时请求体中可省略model字段;但需确认One-API配置中relay/adaptor/gemini/adaptor.go已启用query参数优先级高于body的逻辑。
注意:若使用免费版One-API,部分旧版本存在model字段被静默忽略的问题,建议升级至v0.6.0+并检查adaptor.go第87行是否含if queryModel != "" { return queryModel }判断。
在Google AI Studio Notebook中切换模型
Google官方AI Studio内置的Notebook支持可视化模型选择,但仅限于Studio当前会话绑定的模型列表。
① 打开aistudio.google.com → 进入“Notebooks”标签页 → 点击右上角“+ New Notebook”。
② 在新Notebook左上角点击模型名称(如“Gemini 3 Flash”),弹出下拉菜单。
③ 从列表中选择目标版本,例如Gemini 3.1 Pro;选择后整个Notebook所有后续genai.GenerativeModel()调用将默认使用该模型,无需再传model参数。
④ 若下拉菜单中未出现所需版本,说明该项目未授权该模型访问权限,需前往AI Studio左侧“Settings” → “Model access”中手动勾选并保存。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











