Google AI Studio 入门：调提示词、试参数、导出代码

Google AI Studio 的完整用法：它和 Gemini 应用、Gemini API 的分工，怎么写系统指令、调生成参数、开结构化输出与函数调用，怎么用 Get code 导出调用，以及免费额度下数据会被怎样使用。

它解决的是哪一类问题

AI Studio 是一个网页工作台：在写代码之前，先把提示词和参数调到你满意。

这件事之所以需要专门的工具，是因为在业务代码里迭代提示词非常慢——改一个字要重启服务、跑一次要等日志。AI Studio 把系统指令、生成参数、结构化输出、函数调用这些平时藏在 SDK 参数里的东西全部摊在界面上，改完立刻能看到结果。

它不解决的问题同样明确：并发、重试、超时、成本控制、监控。这些只能在你自己的服务端解决。

三个入口的分工

	Gemini 应用	Google AI Studio	Gemini Developer API
面向谁	使用者	开发者、测试者	开发者
怎么认证	Google 账号	Google 账号	API Key
在这里做什么	完成日常任务	调提示词、试参数、拿密钥	真正的程序调用
能不能上生产	不适用	不能	能

用法上的分界线很干净：在 AI Studio 里确定「要发什么样的请求」，在自己的服务端负责「怎么可靠地发出去」。 网页助手的用法见 Gemini 怎么用，接口调用见 Gemini API 使用教程。

开始之前

• 一个 Google 账号，不需要额外注册。
• 访问 aistudio.google.com；后面写代码时还要能访问 generativelanguage.googleapis.com。
• 准备一组脱敏样例数据。理由见下面关于免费额度的一节——先准备好，比事后后悔省事。

界面上真正要用的四块

新建一个 Chat prompt 之后，值得关心的只有四个地方：

1. 模型选择器：决定这次用哪一档。先用默认档跑通再换。
2. System instructions：系统指令，写角色、约束和输出格式。
3. Run settings：生成参数、安全设置，以及结构化输出、函数调用这类开关。
4. Get code：把当前这次调用导出成代码。

其余的界面元素在调试阶段可以先不管。AI Studio 还提供实时流式对话、视频生成等其他类型的 prompt，用途不同，不影响这条主线。

系统指令该写什么

判断标准只有一条：每次请求都不变的东西写进系统指令，随请求变化的写进用户消息。

写进系统指令的通常是：

• 角色与领域：它在为谁工作、面对什么材料。
• 硬约束：不许编造、材料里没有就说没有、不要输出前言。
• 输出格式：字段、顺序、语言、长度。
• 少量示例：一到两个足够说明格式的例子。

不要写进系统指令的是这次要处理的具体内容。把当次材料塞进系统指令，是新手最常见的结构性错误——它会让你误以为提示词调好了，实际上换一份材料就崩。

一个常被忽略的细节：约束写成「做什么」比写成「不要做什么」更容易生效。 「只使用材料中出现过的数字」比「不要编造数字」稳定得多。

参数怎么调

生成参数不存在通用最优值，只有和你的任务匹配不匹配：

• 温度类参数：控制发散程度。要可复现的结构化结果往低调，要文案创意往高调。
• 采样范围类参数：和温度作用相近，一般只调其中一个，两个一起调很难归因。
• 最大输出长度：截断问题最常见的来源。输出突然中断先查这里，不要先怀疑模型。

有效的调法是固定输入连跑五次，看结果差异是否落在能接受的范围里。只跑一次就下结论，得到的是运气而不是结论。

结构化输出与函数调用

这两个开关是 AI Studio 里最值得花时间的部分，因为它们决定了输出能不能被程序消费。

结构化输出：给出 schema，让模型按字段返回，而不是在提示词里恳求它「只返回 JSON」。区别在于前者是接口层面的约束，后者只是建议。即便如此，解析端仍然要有失败兜底——不要假设返回一定合法。

函数调用：把你的函数签名交给模型，让它决定何时调用、填什么参数。在 AI Studio 里能直接看到它想调哪个函数、参数填成什么样，这比在代码里打日志快得多。

调这两项时特别值得多试边界情况：材料里根本没有所需信息时它会怎么办？给出空值、拒绝、还是硬编一个？这个行为必须在上线前确定。

用 Get code 导出

效果确认后点 Get code，选语言，得到一段可运行的最小示例。

导出的代码是起点，不是成品。 它通常只包含一次调用，你至少还要补上：

• 密钥来源：从环境变量或密钥管理服务读取，不要把示例里的占位符换成明文密钥就提交。
• 超时与重试：网络失败、限流（429）都需要退避重试，不是直接抛出。
• 错误处理：区分参数错误、认证失败、限流、上游故障，处理方式完全不同。
• 用量记录：把返回里的 token 用量记下来，否则成本无从追溯。

导出后第一件要做的事是用同一组输入对照一次：界面里的结果和代码跑出来的结果应该接近。不一致基本都是参数没带全，最常见的就是系统指令丢了。

密钥从这里领，但不要留在这里

API keys 页面就在 AI Studio 里，新用户通常会自动创建好一把。密钥的完整获取流程、环境变量配置与安全要求写在 Gemini API 使用教程 里，这里只强调一条底线：密钥不进前端、不进仓库、不进截图。 需要在前端使用模型能力时，正确结构是前端调你自己的后端，由后端持有密钥。

免费额度的代价

这一节比参数调优更重要，因为它决定了你能往这个界面里贴什么。

官方使用条款对免费与付费的区分写得很直接：

• 免费额度：你提交的内容与模型返回的内容会被用于提供、改进和开发 Google 的产品与服务；人工审阅者可能读取、标注和处理这些输入与输出；官方明确写着不要提交敏感、机密或个人信息。
• 付费额度：Google 声明不使用你的提示词与响应来改进产品，数据按其数据处理条款处理，保留仅用于检测违规与法律合规等目的。

实际做法：用脱敏样例调提示词。 真实客户数据、内部文档、任何密钥都不要出现在免费额度的对话里。确实需要处理真实数据的项目，先切到付费额度并确认对应条款。

什么时候不该用 AI Studio

• 要上生产：它不是运行环境，密钥和可用性不该依赖一个网页。
• 要处理真实敏感数据：见上一节。
• 要压成本与并发：这些指标在界面里看不到，只能在服务端度量。
• 团队要协作管理提示词：提示词版本管理需要进代码库，靠界面里的历史记录管不住。

相关内容

• 产品定位：Google AI Studio
• 接口调用：Gemini API 使用教程
• 网页助手用法：Gemini 怎么用
• 同一件事在别家怎么做：OpenAI API 使用教程、Anthropic Claude API 使用教程
• 接口目录：AI API 目录

参考资料

• Google AI Studio 快速开始（官方文档）
• Gemini API 附加服务条款（官方，含免费与付费额度的数据使用差异）
• 获取并使用 API Key（官方文档）