Skip to content
AI Blog

Gemini API 申请与开发指南

最后更新：2026-08-12· 16 分钟阅读

🚀 快速通道

  • ChatGPT 国内版：点击直达↗
  • 稳定镜像站：打开镜像↗
  • 官方 ChatGPT：chatgpt.com ↗

Gemini API 申请与开发指南

更新时间：2026-09-17。旗舰 Flash 跟进见 Gemini 3.8 Flash（gemini-3.8-flash）。

导读

要把 Gemini 嵌入产品、脚本或自动化流水线，API 是唯一可版本锁定、可计量计费的路径。 本文从 Google AI Studio 申请 Key 开始，带你完成第一次 HTTP 调用，并覆盖模型选择、密钥安全与上线检查项。模型 ID、配额、定价与地区可用性以 Google AI 开发者文档 为准，本文不列出固定价格。

API 与网页版：为什么要走 API？

对比项网页版 GeminiGemini API
集成方式人工复制粘贴程序自动调用
模型锁定产品自动路由请求指定 model
计费订阅制（以账户为准）按 token/请求（以官网为准）
日志与监控浏览器历史自建日志、链路追踪
适用场景个人效率产品功能、批处理、Agent

申请 API Key：分步流程

1）打开 Google AI Studio

  1. 访问 aistudio.google.com。
  2. 使用 Google 账号登录；首次使用按提示同意开发者条款。
  3. 若提示启用 Cloud 计费，按官方引导操作（免费额度与付费门槛以官网为准）。

2）创建 API Key

  1. 进入 Get API key 或左侧「API Keys」。
  2. 选择创建新 Key，关联到 Google Cloud 项目（可按官方向导新建项目）。
  3. 立即复制并妥善保存；Key 只显示一次或需在新页面查看。

3）安全存储

# 示例：写入环境变量（勿提交到 Git）
export GEMINI_API_KEY="your_key_here"
  • 勿把 Key 写进前端 JavaScript 或公开仓库。
  • 生产环境用 Secret Manager 或 CI 密文变量。
  • 定期轮换 Key；泄露后立即在控制台吊销。

第一次调用：REST 最小示例

以下示例使用 generateContent 端点；model 名称请替换为文档中的当前可用 ID（见 模型列表）。

curl "https://generativelanguage.googleapis.com/v1beta/models/MODEL_ID:generateContent?key=${GEMINI_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [{
      "parts": [{"text": "用三句话解释什么是 Gemini API，简体中文。"}]
    }]
  }'

成功时返回 JSON，正文在 candidates[0].content.parts[0].text。

Python SDK 示例（推荐）

import os
from google import genai

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

response = client.models.generate_content(
    model="MODEL_ID",  # 以官网模型列表为准
    contents="用 Markdown 表格列出 API 调用的三个注意事项，中文。",
)
print(response.text)

安装与最新 SDK 用法见 官方快速开始。

模型选择速查

场景建议档位备注
复杂推理、长链分析Ultra 系成本较高，以官网计费为准
日常对话、通用生成Pro 系多数产品的默认选择
高 QPS、低延迟、大批量Flash 系适合预处理与简单分类
多模态（图+文）支持 vision 的型号查阅模型卡片中的 input modalities

生产建议： 配置里用环境变量存 GEMINI_MODEL，便于不停机切换型号；监控 token 用量与错误率。

常用 API 能力一览

能力用途文档方向
generateContent单轮/多轮文本与多模态核心聊天补全
结构化输出 / JSON mode可靠解析字段见官方 structured output 指南
函数调用（Function Calling）Agent、工具链定义 schema 让模型返回 tool call
文件 API大文件、PDF上传后引用 file uri
嵌入（Embeddings）语义搜索、RAG独立 embedding 模型

具体参数名与限制随 API 版本更新，集成时以 ai.google.dev 当前文档为准。

生产环境检查清单

  1. 密钥：仅服务端持有；启用 IP 限制或 Cloud 项目级配额（若官方支持）。
  2. 超时与重试：对 429/5xx 做指数退避；设置合理 timeout。
  3. 输入长度：超长上下文先摘要再生成，控制成本。
  4. 输出审核：敏感场景加关键词过滤与人工抽检。
  5. 日志：记录 model、token 用量、latency；勿记录用户隐私原文。
  6. 弃用监控：订阅 Google 模型弃用公告，预留迁移窗口。

可直接复制的 3 条「开发向」系统提示词

在 API 请求的 system 或首条 user 消息中使用：

1）JSON 结构化输出

你只能输出合法 JSON，不要 Markdown 代码块。
schema: {"title": string, "bullets": string[], "confidence": "high"|"medium"|"low"}
根据用户输入填充字段；不确定时 confidence 为 low。

2）RAG 问答（带材料）

只根据以下「参考材料」回答；材料未提及的内容回答「材料中未说明」。
材料：
---
{context}
---
问题：{question}

3）代码审查

审查以下代码，输出：① 严重问题（若有）② 建议改进 ③ 需本地运行的测试命令。
不要编造不存在的 API；语言中文。
代码：
{code}

国内开发者注意事项

  • API 请求从 服务器所在地区 发出，需符合 Google Cloud / AI 平台支持区域与合规要求。
  • 个人无法在境内稳定访问时，可考虑在海外 VPS/Cloud Run 上部署调用层。
  • 开发调试可先在本机配合合法网络；勿将 API Key 提交到公开 GitHub 仓库。
  • 网页端体验可参考 Gemini 官网入口与国内使用；并行对比 ChatGPT Platform 或 ChatGPT 国内版 仅用于产品交互参考，非 API 等价替代。

常见问题

AI Studio 的 Key 和 Vertex AI 一样吗？

不完全一样。消费级 Google AI Studio / Gemini API 与 Vertex AI 是企业 GCP 路径，认证方式、计费与 SLA 不同。小项目与原型优先 AI Studio；大企业已有 GCP 可评估 Vertex。详见官方对比文档。

免费额度有多少？

免费层额度与限制会调整，以 定价页 实时说明为准。超出后按量计费或需绑定账单。

如何处理 429 RESOURCE_EXHAUSTED？

表示配额或速率限制触发。降低并发、换 Flash 型号、申请提额或启用缓存策略；并检查是否误把 Key 暴露导致被盗刷。

可以用 Gemini API 做商业产品吗？

需阅读 Google API 服务条款与生成式 AI 使用政策；部分行业有额外限制。上线前请法务审阅。

官方资源

下一步阅读

行动路径

今天：在 AI Studio 创建 Key，用 curl 或 Python 跑通第一次 generateContent。明天：把 Key 迁入环境变量，删掉代码里的明文。本周：选一条「开发向」系统提示词接入业务原型，并阅读 3.8 Flash 换挡 与 3.5 Flash 评测 评估成本档位。

相关内容