Gemini API Key 上手指南

用自己的 Gemini API Key 聊天,不用写代码

在 Google AI Studio 拿到 Gemini API Key,搞清免费层和付费层的区别,再在 iPhone、Android 或网页上的聊天应用里使用 Gemini。全程不用写代码。

Oriveo Team发布于 更新于 约 6 分钟
  • 想自带 Key、不写代码用 Gemini,先在 Google AI Studio(aistudio.google.com/apikey)创建 API Key,再粘贴进 Oriveo 这类 BYOK 聊天应用。之后的请求,要么按这个 Key 所属的 Google Cloud 项目计费,要么算进免费层的限额。
  • Gemini API 的很多模型有免费层,包括 Flash 系列,但免费层里的内容可能被 Google 用来改进它的产品;也有一些模型只能付费用,比如 Gemini 3.1 Pro Preview。
  • 走付费层的话,截至 2026 年 9 月 28 日,Gemini 3.8 Flash 每百万输入 token 0.75 美元、每百万输出 token 3.75 美元,一条普通聊天消息的预估费用连 1 美分都不到。
iPhone 上的 Oriveo 对话列表,每条对话右侧标着它的预估费用。

Gemini API 和 Gemini 应用有什么不同

Google 提供 Gemini 的方式有两种。Gemini 应用(有免费版,也有付费的 Google AI 订阅)是面向个人的产品;Gemini API 是面向开发者的产品:你创建一个 API Key,软件(包括支持填自己 Key 的聊天应用)就能替你向 Gemini 模型发请求。

API 在 Google AI Studio 里管理,背后是一个 Google Cloud 项目。Google 文档写明:每个 Gemini API Key 都属于某个 Google Cloud 项目,账单、协作者和权限都在这个项目里管;速率限制按项目算,不按 Key 算。想付费使用 API,要把 Cloud 结算账号关联到这个项目上,所以别以为个人的 Google AI 订阅能抵 API 请求的费用。

第 1 步:创建 Gemini API Key

创建 Key 用不了一分钟,只用免费层的话也不需要绑信用卡。第一次用 AI Studio,同意服务条款后,它会替你建好默认的 Google Cloud 项目和一个 API Key。

  • 打开 aistudio.google.com/apikey,用你的 Google 账号登录。
  • 如果弹出服务条款,点同意;新用户会自动得到一个默认项目和 Key。
  • 创建一个 API Key,或者复制已经建好的那个,顺便记下它属于哪个项目。
  • 把 Key 存到安全的地方,比如密码管理器。Gemini 的 Key 一般以「AIza」开头。

第 2 步:选免费层还是付费层

用 Gemini,这是最要紧的一个决定,因为两个层级差的不只是价格。定价页会列出每个模型的免费层是「Free of charge」(免费)还是「Not available」(不可用),也会写明两个层级各自怎么处理你的内容。

免费层:Google 定价页写的是,内容会被用来改进它的产品;付费层:写的是内容不会被用来改进它的产品。如果你打算往里贴个人隐私或保密的内容,光凭这一点就值得把结算账号关联上,哪怕你的用量在免费限额之内。

速率限制也不一样。没关联结算账号的项目走免费层;关联了有效的结算账号就升到 Tier 1,再往上的档位取决于累计消费。限额因模型而异,Google 说明这些数字会显示在 AI Studio 里,档位变了会自动更新。

第 2 步:选免费层还是付费层
免费层付费层(已关联结算账号)
每个 token 的费用标注「Free of charge」的模型不收费按公布的 token 价格收费
可用的模型很多模型,包括 Flash;部分 Pro 预览版不可用列出的所有模型
内容怎么用(以 Google 定价页为准)会被用来改进 Google 的产品不会被用来改进 Google 的产品
速率限制每个项目按免费层限额每个项目按 Tier 1 及以上

付费层用 Gemini 要花多少钱

下表是截至 2026 年 9 月 28 日 Google 公布的三款当前模型的付费层价格(提示词不超过 20 万 token 的部分),并按一条普通聊天消息估算费用:2,000 个输入 token、600 个输出 token。注意 Gemini 3.8 Flash 的价格分时间段:到 2026 年 12 月 31 日,输入 0.75 美元、输出 3.75 美元;从 2027 年 1 月 1 日起,输入 1.50 美元、输出 7.50 美元。

以 Gemini 3.8 Flash 为例,算式是 2,000 × 0.75 美元 ÷ 1,000,000 + 600 × 3.75 美元 ÷ 1,000,000 = 0.00375 美元,不到半美分。对话越长,每条消息越贵,因为前面几轮会作为输入重新发一遍;最终金额以 Google 的账单为准。

付费层用 Gemini 要花多少钱
模型输入(美元 / 百万 token)输出(美元 / 百万 token)免费层一条普通消息的预估费用
Gemini 2.5 Flash-Lite0.100.40免费约 $0.0004
Gemini 3.8 Flash0.75(2027 年 1 月 1 日起 1.50)3.75(2027 年 1 月 1 日起 7.50)免费约 $0.004
Gemini 3.1 Pro Preview2.0012.00不提供约 $0.011

第 3 步:在 Oriveo 里填入 Key

Oriveo 是一款支持 iPhone、Android 和网页的多模型聊天应用,用你自己的 Key 来调用模型。Google Gemini 是它的 15 家官方供应商之一,在「直连 AI 供应商」分组里。下表里的按钮名称,以你应用里实际显示的为准。

点继续后,Oriveo 会向 Google 请求这个 Key 能访问的模型来验证 Key,再把列表同步下来。Key 要是被 Google 拒绝,会马上提示,改好再聊就行。

第 3 步:在 Oriveo 里填入 Key
步骤iPhoneAndroid网页
打开供应商列表底部的 Providers 标签底部的 Providers 标签侧边栏里的 Providers
开始添加添加供应商(Add Provider)添加供应商(Add Provider)添加供应商(Add Provider)
选择供应商「直连 AI 供应商」下的 Google Gemini「直连 AI 供应商」下的 Google Gemini「直连 AI 供应商」下的 Google Gemini
粘贴 Key「连接 Google Gemini」下面的 API Key 输入框「连接 Google Gemini」下面的 API Key 输入框Key 输入框;「在 Google Gemini 获取你的 Key」直接跳到 AI Studio
确认继续继续继续

第 4 步:选模型,开聊

连上之后,Gemini 的模型会出现在模型选择器里。Flash 系列速度快、价格低,日常聊天基本够用;Pro 系列留给更难的推理和更长的分析。如果你的 Key 走的是免费层,就只选定价页标了免费的模型,因为只能付费用的模型在没关联结算账号时会报错。

聊到一半可以换模型,也能换成你连过的其他供应商的模型,还在同一个对话里接着聊。每条消息旁边都会按 Google 公布的价格显示预估费用;走免费层时要记得,免费模型本来就不收费,真正的约束是速率限制。

常见报错和它们的意思

Gemini 的报错通常写得比较具体,能直接看出原因。

  • 「API key not valid」:Key 没复制完整、已被删除,或者被设了限制。回 AI Studio 重新复制,或者新建一个。
  • 速率限制或 resource exhausted:你已经达到项目在该模型上的每分钟或每天上限。等一等、换个模型,或者关联结算账号来拿到更高的限额。
  • 你的档位不能用这个模型:有些模型只能付费用。给项目关联结算账号,或者换一个免费的模型。
  • 几个 Key 一起撞上限额:限额按项目算,同一个项目里的 Key 共用同一份。

把 Key 保管好

关联了结算账号之后,Gemini 的 Key 能花你的钱;就算没关联,它也能把你的免费额度用光。Oriveo 把供应商的 Key 存在你的设备或浏览器里,不作为账号数据保存。iPhone 和 Android 应用直接把请求发给 Google;网页版走一个转发接口,不保留 Key,也不保留 BYOK 聊天内容。Oriveo 不在 Google 的价格上加价。

建议给聊天应用单独用一个项目或一个 Key,定期在 AI Studio 和 Cloud 控制台里看用量,一旦 Key 泄露就把它删掉。

常见问题

Gemini API 免费吗?
一部分免费。很多 Gemini 模型有免费层,在速率限制之内不收费,但也有一些模型只能付费用,比如 Gemini 3.1 Pro Preview。另外,Google 定价页写明:免费层的内容会被用来改进它的产品,付费层则不会。
去哪里拿 Gemini API Key?
在 Google AI Studio,地址是 aistudio.google.com/apikey。新用户同意条款后会得到一个默认的 Google Cloud 项目和 Key。每个 Key 都属于某个 Cloud 项目,账单和速率限制都由这个项目管。
Google AI Pro 订阅包含 Gemini API 的用量吗?
别想当然。面向个人的 Google AI 订阅管的是 Gemini 应用,而付费使用 Gemini API,要给 Key 所属的项目关联 Cloud 结算账号。可以在 AI Studio 里查看你项目的账单情况。
用自己的 Key 调用 Gemini,要花多少钱?
走付费层的话,截至 2026 年 9 月 28 日,到 2026 年 12 月 31 日之前,Gemini 3.8 Flash 每百万输入 token 0.75 美元、每百万输出 token 3.75 美元,一条普通聊天消息的预估费用约 0.004 美元。
能在 iPhone 和 Android 上用 Gemini API Key 吗?
可以。在 Oriveo 里打开 Providers,点添加供应商,选 Google Gemini,粘贴 Key,点继续。原生应用会直接把请求发给 Google,同一个 Key 在网页版里也能用。

延伸阅读

用自己的 Key 使用 Gemini

在 iPhone、Android 或网页上的 Oriveo 里填入你的 Gemini Key,在 Gemini 和另外 700+ 个模型之间随时切换,每条消息都能看到预估费用。