Google AI Studio 开发者实战：Gemini API Key申请、提示词调优与代码集成

掌握 Google AI Studio 免费申请 Gemini API 密钥、系统提示词 (System Instructions) 调优、结构化 JSON 输出与 Python/TypeScript SDK 代码集成。

Google指南编辑组

更新时间：2026-08-16

核验状态：已于 2026-08-15 验证

阅读时长：约 14 分钟

难度：专业实操教程

核心快速答案 (Quick Answer)

直接结论

在 Google AI Studio 中开发大模型应用的三个核心步骤：在 aistudio.google.com 点击'Get API key'瞬间生成免费 API 密钥；在 System Instructions 中定义严谨的输出规则（如设定 Response MIME type 为 application/json）；点击'Get Code'一键导出原生 Python 或 TypeScript 调用脚本。

💡 基于官方文档与实机测试核验核验时间：2026-08-15

快速结论与 AI Studio 免费调用额度说明

Google AI Studio 是 Google 官方为全球开发者量身打造的快速实验、Prompt 原型设计与获取 Gemini API 密钥的图形化工作台。

相比于需要繁琐绑卡和配置企业计费的传统平台，Google AI Studio 提供了极具诚意的 免费调用层级（Free Tier）：

指标维度	免费层级 (Free Tier)	付费即用层级 (Pay-as-you-go)
每分钟请求上限 (RPM)	15 RPM (Gemini Flash)	1,000+ RPM
每天请求上限 (RPD)	1,500 RPD	无限
每分钟 Token 上限 (TPM)	100 万 TPM	400 万+ TPM
是否需要绑定信用卡	完全不需要，登录 Google 账号即可使用	需要绑定 GCP 结算账户

获取 Gemini API 密钥 (API Key) 实操

获取步骤

登录 Google AI Studio 官方控制台。
在左侧导航栏点击顶部带有钥匙图标的 “Get API key”。
点击 “Create API key”（在新的 GCP 项目中创建或选择已有项目）。
系统将在数秒内生成一个以 AIzaSy... 开头的字符串，点击复制并妥善保管在本地 .env 环境变量文件中。

强制模型输出标准 JSON 格式与 Schema 约束

在实际软件开发中，最痛苦的问题莫过于大模型输出多余的开场白或 Markdown 符号导致程序 JSON 解析崩溃。AI Studio 原生支持基于受限解码（Constrained Decoding）的严格 JSON 输出。

配置方法

在右侧模型参数面板中，找到 “Advanced settings”。
将 “Response MIME type” 从默认的 text/plain 切换为 application/json。

在 System Instructions 中填入 JSON 约束，例如：

{
  "status": "success",
  "summary": "string",
  "confidence": "number"
}

模型将强制保证每个 Token 100% 符合 JSON 语法规范，可以直接被后端代码安全解析。

Python 与 TypeScript SDK 完整调用代码

1. Python SDK 调用示例

安装官方库：

pip install -q -U google-generativeai

编写 app.py：

import google.generativeai as genai
import os

genai.configure(api_key=os.environ.get("GEMINI_API_KEY"))

model = genai.GenerativeModel(
    model_name="gemini-1.5-flash",
    system_instruction="你是一位专业的技术文档审查员，请用简体中文进行客观、精炼的事实分析。"
)

response = model.generate_content("请列举 Astro 框架实现静态预渲染 (SSG) 的三大核心优势。")
print(response.text)

2. TypeScript / Node.js SDK 调用示例

安装官方 npm 包：

npm install @google/generative-ai

编写 index.ts：

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

const genAI = new GoogleGenerativeAI(process.env.GEMINI_API_KEY!);
const model = genAI.getGenerativeModel({ model: "gemini-1.5-flash" });

async function run() {
  const result = await model.generateContent("你好，请用一句话介绍 Google Cloud。");
  console.log(result.response.text());
}
run();