Beongeurim

Gemini API 密钥获取指南

这里说明如何在 Google AI Studio 创建你自己的密钥。只要照着界面点击就行,大约需要 5 分钟。下面的界面图片是韩语版。

开始前的准备

请先了解
  1. 打开 AI Studio 的密钥页面

    在浏览器地址栏输入下面的地址,或者点击它打开。

    https://aistudio.google.com/apikey

    如果还没有登录 Google,会先出现登录界面。选择账号,再点击继续下一步的按钮登录。如果是第一次使用这个账号,可能会出现同意条款的界面,请阅读内容后再继续。

    根据官方文档,新用户同意条款后,AI Studio 会自动创建一个默认项目和一个 API 密钥。如果列表里已经有密钥,可以直接用,也可以从下面的第 2 步开始重新创建。

    浏览器地址栏里写着 aistudio.google.com/apikey,下方有用 Google 账号登录的方框和下一步按钮的示意图
    这是对真实界面的简化示意图。登录界面的样子会因账号状态而不同。
  2. 点击创建密钥的按钮

    登录后会出现 API 密钥列表界面。请在界面右上角找到创建 API 密钥的按钮并点击(图片里的韩语界面中,它的名称是「API 키 만들기」)。下面图片中的红框就是这个按钮。

    下面的截图是韩语界面。你屏幕上的文字可能不一样。

    API 密钥列表界面。右上角的创建 API 密钥按钮被红框框住,下方的列表有密钥、项目、创建日期、结算等级几列。个人信息已被遮挡。
    这是真实界面(个人信息已遮挡)。在手机上文字会显得很小。点击图片可以按原始大小打开。

    按钮的位置会因屏幕大小稍有不同。这时请找作用相同的按钮。列表左侧菜单中有这些项目(韩语界面中的名称):「API 키 · 프로젝트 · 사용량 · 비율 제한 · 지출 · 결제」(API 密钥、项目、使用量、速率限制、支出、结算)。

  3. 填写名称并选择项目

    会打开创建新密钥的窗口(图片中是「새 키 만들기」)。里面有两个栏。

    • 密钥名称栏(图片中是「키 이름 지정」) — 填写一个容易辨认的名称。一开始已经填好了 'Gemini API Key',保持不变也可以。
    • 项目栏(图片中是「가져온 프로젝트 선택」) — 第一次使用时,已经选好了 'Default Gemini Project',保持不变就可以。

    准备好后,点击右下角的创建密钥按钮(图片中是「키 만들기」)。想放弃的话,点击旁边的取消按钮(图片中是「취소」)。

    下面的截图是韩语界面。你屏幕上的文字可能不一样。

    创建新密钥的窗口。密钥名称栏里是 Gemini API Key,项目栏里是 Default Gemini Project,右下角的创建密钥按钮被红框框住。
    这是真实界面。

    如果还没有项目

    点击项目栏,会展开一个列表。在那里点击创建新项目的选项(图片中是「+ 프로젝트 만들기」),就可以创建新项目。列表里还有导入项目的选项(图片中是「프로젝트 가져오기」),是给已经用过 Google Cloud 的人导入现有项目用的。第一次使用的话不需要用它。

    项目栏展开后的样子。可以看到导入项目和创建项目的选项,创建项目被红框框住。
    这是真实界面。
    如果提示没有权限

    根据官方文档,在公司或学校账号这类有管理员的项目里,可能会提示你没有创建密钥的权限。这时可以向管理员申请权限,或者创建一个不属于任何组织的新项目来使用。如果是个人 Google 账号,通常没有关系。

  4. 复制密钥

    密钥创建好后,列表里会多出一行。在那一行最右端的图标中,点击复制图标来复制密钥。行的右侧有好几个图标(复制、结算、使用量、数据、三点菜单)。

    具体样子可能因界面而不同。如果另外出现了可以查看密钥的栏,从那里复制也一样。密钥通常是由英文字母和数字混合而成的一长串字符。

    密钥列表的一行。显示密钥名称 Gemini API Key、被遮挡的密钥值示例、项目名称和免费等级,行最右端的复制图标被红框框住。
    这是对真实界面的简化示意图。密钥值示例是故意遮挡的。
    复制的密钥不要随便粘贴

    如果把密钥粘贴在别人能看到的地方,那个人就可以用你的密钥发送请求。请只粘贴到 Beongeurim 工具的密钥栏里。

  5. 粘贴到 Beongeurim 工具中

    工具打开后,输入密钥的栏会出现在最上面。请把复制的密钥粘贴进去(电脑按 Ctrl+V,手机长按输入栏选择“粘贴”)。

    在此之前,请先核对地址栏。Beongeurim 工具的真实地址只有下面这一个。不要在长得相似的其他地址输入密钥。

    https://beongeurim-tool.pages.dev

    • “记住此设备”默认是关闭的。保持关闭的话,关闭标签页时密钥就会消失。
    • 如果只在自己的电脑或手机上使用,可以打开。在学校、网吧或借来的设备上不要打开。
    Beongeurim 工具界面的预定样子。地址栏里是 beongeurim-tool.pages.dev,下面的密钥栏里有被遮挡的密钥,“记住此设备”的方框是关闭的。
    工具还在制作中,所以这是预定样子的简化示意图。实际界面可能不同。

    即使工具还没有开放,也可以提前创建好密钥。

保管密钥和删除密钥

官方文档要求像对待密码一样对待 Gemini API 密钥。一旦泄露,别人可能用掉你项目的用量,也可能产生意想不到的费用。

要删除密钥时

回到 AI Studio 的 API 密钥列表,打开该密钥那一行最右端的三个点(⋮)菜单,选择删除即可。菜单里的文字可能因界面而略有不同。用完之后或不再使用时,把密钥删掉更安全。

如果觉得密钥可能泄露了

官方文档给出的顺序如下。

  1. 创建新密钥。
  2. 把原来使用密钥的地方换成新密钥。
  3. 确认新密钥能正常使用后,再停用或删除旧密钥。
  4. 查看使用量,看有没有不是自己进行的使用。

常见问题

不设置结算也可以吗?

可以,不用设置。根据官方文档,新账号从免费等级开始,免费等级可以在规定的限额内使用部分模型。如果密钥列表的结算等级一栏显示的是免费等级(图片中的韩语界面里是「결제 등급」和「무료 등급」),就是免费密钥。

点击同一栏里设置结算的链接(图片中是「결제 설정」)并关联结算账号,就可以升级为付费等级。如果只想免费使用,请不要点。我们看到的创建密钥窗口里,没有询问付款信息的栏。

“每日限额”是什么?

是用免费密钥一天内可以发送的请求次数。官方文档说限额从三方面衡量:每分钟请求数、每分钟文字(token)数、每天请求数,只要有一项超过就会出错。

  • 限额是按项目而不是按密钥算的。在同一个项目里创建多个密钥,限额也是合在一起计算。
  • 每日限额在美国太平洋时间的午夜重新开始。换成韩国时间,大约是下午 4 点(美国夏令时期间)或下午 5 点(其他时间)。这个韩国时间是我们自己计算的值。
  • 每个模型的限额不同。在 Beongeurim 团队确认过的模型上,每天大约 20 次,但可能会变。你的密钥的准确数字,可以在左侧菜单的速率限制界面查看(图片中是「비율 제한」)。

翻译一张图片至少需要发一次请求。所以一天能翻译的图片数量可能少于 20 张。

出现 429 错误

429 的意思是“请求太多”,是超过限额的信号。官方文档也说超过限额会出现 429 错误。这时请稍等一会儿再试,或者如果每日限额已经用完,就等限额重新开始的时间(见上面的说明)。我们正在把 Beongeurim 工具做成遇到 429 时尝试换另一个模型。

类似地,503 表示 Google 那边正忙。请过一会儿再试。

以前创建的密钥不能用了

根据官方文档,从 2026 年 5 月 28 日起,在 AI Studio 新创建的密钥会自动成为“认证密钥(auth key)”。另外,Gemini API 不接受没有限制的旧式密钥,长期不用的无限制密钥会被封锁并显示 Blocked 标记。对于这样的密钥,与其修复,创建新密钥最快。

我把密钥弄丢了

在 AI Studio 的密钥列表里能不能再次看到密钥,可能因界面而不同。找不到的话,请按上面的第 2 到 4 步创建新密钥,并把丢掉的密钥从列表中删除。重新创建后,只要是同一个项目,每日限额是接着算的。

官方文档说“不要把密钥放进网页应用”,这是怎么回事?

官方文档里的这个警告,指的是开发者把自己的密钥写进网页应用的代码里,让所有访问者都用这一个密钥的情况。Beongeurim 不这样做。Beongeurim 里一个密钥都没有,每个人在自己的浏览器里用自己的密钥。不过密钥在你的浏览器里这一点是一样的,所以请核对工具地址,并在公共设备上关闭记住功能。

我住在欧洲或英国

Gemini API 条款规定,面向欧洲经济区(EEA)、英国和瑞士用户提供的服务,只能使用付费服务。所以我们告知这些地区需要付费密钥。这不是法律判断。请你自己在 Google 官方网站上确认条款。

参考的官方文档

界面和政策可能被 Google 更改。如果与本指南不一致,以官方文档为准。

创建好密钥之后

Beongeurim 工具开放后,按上面第 5 步粘贴即可。工具现在还在制作中。

返回 Beongeurim 简介