一句话简介：Gemini 是 Google 推出的闭源大模型家族（当前旗舰 Gemini 4 Argon）。

主流功能：软件工程、企业知识工作（法律/金融）、网络安全攻防

可用性：需特殊网络环境——国内不可直接使用。

适用人群：想免费体验顶级闭源模型的开发者、学生、技术爱好者

前置条件：

• 网络：可访问 Google 服务的网络环境（AI Studio 对部分地区 IP 有限制）
• 账号：一个 Google 账号（注册需境外手机号验证，一次搞定长期用）
• 费用：免费层级即可用，无需绑卡
• 开发环境：Python 3.9+ 或 Node.js 16+（二选一）

---

第一部分：在 Google AI Studio 获取免费 API Key

步骤 1：访问并登录

1. 打开 https://aistudio.google.com（需境外网络）。
2. 用你的 Google 账号登录。

步骤 2：创建 API Key

1. 点击左侧边栏的 Get API key。
2. 点击 Create API key in new project（在新项目中创建；也可以选已有 Google Cloud 项目）。
3. 几秒钟后生成一串以 AIza 开头的字符——这就是你的 API Key。
4. 立即复制保存，不要泄露给他人。可在同一页面随时删除/重新生成。

步骤 3（建议）：确认配额可用

1. 访问 AI Studio 的用量页查看速率限制，确认你想用的模型配额层级不是"不可用"。
2. 若全部显示不可用，通常是账号/地区问题，换 Google 账号重试。

第二部分：先在网页里免费体验（不用写代码）

1. 在 AI Studio 主界面中间输入框直接提问，右侧 Run settings 可选模型（如 Gemini 4 Argon / Flash 系列）。
2. System Instructions（系统指令）：在顶部输入框给 AI 设定人设，如"你是一名资深 Python 架构师"，之后所有回答都按这个人设来。
3. Temperature：0 最严谨（适合代码/数学），1 最发散（适合创意写作）。
4. 调好后点 Get code 可一键把当前配置转成 Python/JS/cURL 代码，直接拿去用。

第三部分：用代码调用 Gemini API

Python 方式

pip install -q -U google-generativeai

import google.generativeai as genai

genai.configure(api_key="AIza-你的key")  # 建议从环境变量读取

model = genai.GenerativeModel("gemini-4-argon")  # 模型名以官方文档为准
response = model.generate_content("用中文写一首关于程序员的七言绝句")
print(response.text)

Node.js 方式

npm install @google/generative-ai

import { GoogleGenerativeAI } from "@google/generative-ai";

const genAI = new GoogleGenerativeAI("AIza-你的key");
const model = genAI.getGenerativeModel({ model: "gemini-4-argon" });

const result = await model.generateContent("用中文介绍一下杭州");
console.log(result.response.text());

接入第三方客户端（免写代码）

Cherry Studio、NextChat 等客户端都支持自定义 Gemini 接口：

1. 在客户端设置中找到"API 服务商"→ 添加 Gemini / 自定义。
2. API Key 填 AIza...，API 地址保持默认 https://generativelanguage.googleapis.com。
3. 选择模型（如 gemini-4-argon），保存后即可对话。注意客户端同样需要境外网络才能连通。

---

常见问题

1. 打开 aistudio.google.com 显示地区不可用？ 换美国/新加坡等支持地区的节点重试；部分新注册 Google 账号需先正常使用一段时间。
2. 免费额度用完了怎么办？ 免费层级按模型有每分钟/每天的速率限制（Rate Limits），超限等恢复或换模型（如 Flash 系列额度更高）；高频需求可升级付费层级（需境外支付）。
3. 提示 API Key 无效（API_KEY_INVALID）？ 检查是否复制完整（以 AIza 开头）、Key 是否被删除；确认调用的是 generativelanguage.googleapis.com 而非 Vertex AI 地址。
4. 免费层级的数据隐私问题？ 官方说明免费层级输入可能被用于改进模型；涉及商业机密/个人隐私请用付费层级或 Vertex AI。
5. 国内有没有免网络的替代？ 部分 API 聚合/中转站提供 Gemini 模型（OpenAI 兼容接口），人民币结算、国内直连，但属非官方渠道，稳定性与合规风险自负；模型名以中转站文档为准。

---