10 分钟上手 Gemini API：用 Python 调用 Gemini 4 Argon

会一点 Python、想把 Gemini 4 Argon 接到脚本里？别先读完半本文档——先拿到付费层 Key，跑通下面这段，再谈缓存与省钱。

前置：Google 账号；Gemini API 付费层（免费层调不到 Argon）；Python 3.10+；能访问 Google AI。首发优惠至 2026-11-30 约 $2/$10 每百万 token，之后约翻倍——以官网为准。

完成线只有一条：本地成功打印一段 Argon 回复。鉴权与模型 ID 搞不对，后面全是空转。

第一步：Key 放对环境变量

1. 打开 aistudio.google.com，创建 API Key；确认项目已开通结算。
2. 写入环境变量，不要进仓库：

export GEMINI_API_KEY="你的密钥"

泄露了立刻轮换。更稳：.env + set -a; source .env; set +a，并把 .env 写进 .gitignore。

第二步：装 SDK，跑第一段

python3 -m venv .venv && source .venv/bin/activate
pip install -U google-genai

from google import genai
client = genai.Client()
resp = client.models.generate_content(
    model="gemini-4-argon",
    contents="用三句话解释什么是混合专家模型（MoE），面向后端工程师。",
)
print(resp.text)

404 / model not found：查 ID 与地区。权限/billing：回 AI Studio 确认付费层。

流式（可选）与省钱

stream = client.models.generate_content_stream(
    model="gemini-4-argon",
    contents="列出把单体服务拆成三个模块的步骤，分点输出。",
)
for chunk in stream:
    print(chunk.text or "", end="")

• 短问答用 Flash 等更轻量型号；Argon 留给跨文件重构、超长综合、多步代理。
• 重复长文档开上下文缓存（官方称缓存输入约 95% 折扣）；先无缓存跑通再开。
• 预算按 11 月 30 日后正式价估，别被首发价误导。

排错速查

常见坑

• 免费层调 Argon → 换付费项目。
• Key 写进前端 → 任何人刷你的账单。
• 一次塞超长无关日志 → 先检索再喂，或分段总结。

结构化输出与最小项目结构

resp = client.models.generate_content(
    model="gemini-4-argon",
    contents=(
        "从下面会议纪要提取待办，输出 JSON 数组，"
        "字段: owner, task, due。不要 Markdown。\n" + notes
    ),
)
print(resp.text)

生产环境对 JSON 做 schema 校验；解析失败就重试并收紧提示，别默默吞掉。

my-gemini-app/
  .env                 # GEMINI_API_KEY=...
  .gitignore           # 忽略 .env 与 .venv
  requirements.txt     # google-genai
  smoke_gemini.py      # 冒烟脚本
  app.py               # 业务入口

把模型 ID 做成配置而不是硬编码，方便以后换成 Flash 或更新旗舰。多模型兜底时，抽象一层 LLMClient.generate(prompt, model=...)，供应商差异关在适配器里。

安全：日志打码 Key；对用户输入做长度限制，防止提示词注入覆盖系统指令。企业 VPC/专有服务以 Google Cloud 文档为准，本文聚焦 AI Studio 快速上手。

最后

完成标准：① 环境变量有 Key 且未进 Git；② 冒烟脚本对 gemini-4-argon 返回非空文本；③ 能说清 Argon 用于重任务、轻量模型用于日常。模型名与价目以 Google Gemini API 文档为准——今天只做一件事：把 smoke_gemini.py 跑绿。