Gemini API国内接入教程：直连调用与实战场景详解

国内直连 Google API 确实不通，aistudio.google.com 打不开，generativelanguage.googleapis.com 也连不上。解法是用 API 聚合平台中转，改两行代码，其他不动。咱们这就一步步来，把 Gemini API 在国内的合法接入流程跑通。

第一步：了解现状与准备工具Gemini 3.1 Pro 是 2026 年 2 月 19 日发布的，ARC-AGI-2 抽象推理 77.1%（上一代是 31.1%），SWE-Bench Verified 80.6%，1M token 上下文。但官方渠道在国内无法直连，所以需要找一个支持 Gemini 模型的 API 聚合平台。你只需要准备一个 Python 环境，以及一个 API 密钥——从聚合平台获取就行。

第二步：修改代码实现直连调用打开你的 Python 脚本，找到调用 Google API 的那部分。原来代码里用的是 generativelanguage.googleapis.com 这个地址，现在把它换成聚合平台提供的 base_url。同时，把 API key 换成你在平台上生成的密钥。就这两处改动，其他代码逻辑完全不用动。举个例子，原来写 client = genai.Client(api_key="YOUR_KEY")，现在改成 client = genai.Client(api_key="PLATFORM_KEY", base_url="https://api.platform.com")。是不是挺简单的？

第三步：选择模型与实战场景Gemini 3.1 系列有三个模型：Gemini 3.1 Pro 的模型 ID 是 google/gemini-3.1-pro-preview，输入价格 $2/M，输出价格 $12/M，适合复杂推理、长文档和 Agent 场景。为什么推荐这个？因为它的推理能力确实强，处理长文档时 1M token 上下文能一次性读完整本书。实战中，你可以用它做代码审查、合同分析，或者搭建一个智能客服系统。

总结要点国内接入 Gemini API 的核心就三步：找对聚合平台、改两行代码、选对模型。记住，官方渠道不通，但通过合法中转平台，你照样能享受 Gemini 3.1 Pro 的强大能力。别犹豫了，动手试试吧！