Gemini API 国内接入教程：从申请密钥到首次调用完整指南

国内直连 Google API 确实不通，aistudio.google.com 打不开，generativelanguage.googleapis.com 也连不上。解法是用 API 聚合平台中转，改两行代码，其他不动。下面咱们一步步走完 Gemini API 国内接入教程：从申请密钥到首次调用完整指南。

第一步：通过聚合平台申请密钥既然直连不行，就得找靠谱的中转服务。以 OfoxAI 这类聚合平台为例，注册后创建应用，选择 Gemini 3.1 Pro 模型（模型 ID 为 google/gemini-3.1-pro-preview），系统会自动生成专属 API 密钥。这一步其实挺简单，关键是选对模型——Gemini 3.1 Pro 是 2026 年 2 月 19 日发布的，ARC-AGI-2 抽象推理 77.1%（上一代是 31.1%），SWE-Bench Verified 80.6%，1M token 上下文，适合复杂推理和长文档场景。价格方面，输入 $2/M，输出 $12/M，心里有个数就行。

第二步：配置环境，改两行代码拿到密钥后，在代码里把 API 端点换成聚合平台提供的地址，再把 api_key 换成你的密钥。其他参数完全不用动——模型 ID、请求格式、超时设置都保持原样。这就完成了接入，是不是比想象中省事？

第三步：首次调用，验证连通性写个简单的 Python 脚本，发送一条“你好，Gemini”的请求。如果返回正常响应，说明国内接入成功。这里有个小提醒：首次调用建议用短文本测试，确认网络和密钥都没问题。没错，整个过程核心就是“换端点、换密钥”这两步。

总结要点国内接入 Gemini API 的关键在于使用官方渠道的聚合平台中转，而非直连。步骤只有三步：申请密钥、改两行代码、首次调用。记住模型选 google/gemini-3.1-pro-preview，价格按 $2/M 输入、$12/M 输出算。何来复杂之说？照着做，十分钟就能跑通。