Gemini API 金鑰指南

不用寫程式,在 App 裡使用你的 Gemini API 金鑰

在 Google AI Studio 取得 Gemini API 金鑰,搞懂免費層和付費層的差別,然後在 iPhone、Android 或網頁的聊天 App 裡使用 Gemini——不用寫程式。

Oriveo Team發布於 更新於 約 6 分鐘
  • 想用自己的金鑰、不寫程式地使用 Gemini:在 Google AI Studio(aistudio.google.com/apikey)建立 API 金鑰,再貼進 Oriveo 這類 BYOK 聊天 App。之後請求就記在這把金鑰所屬的 Google Cloud 專案上——計費,或計入免費層限額。
  • Gemini API 對許多模型提供免費層,包含 Flash 家族,但免費層的內容可能被 Google 用來改進它的產品;有些模型,例如 Gemini 3.1 Pro Preview,只有付費版。
  • 付費層方面,截至 2026 年 9 月 28 日,Gemini 3.8 Flash 每百萬輸入 token $0.75、每百萬輸出 token $3.75——一則典型聊天訊息預估遠低於一分錢。
iPhone 上的 Oriveo:對話清單,每則對話右側顯示預估費用。

Gemini API 和 Gemini App 差在哪

Google 提供 Gemini 的方式有兩種。Gemini App ——含免費方案和付費的 Google AI 方案——是消費端產品。Gemini API 是開發者產品:你建立 API 金鑰,軟體——包含接受你自己金鑰的聊天 App ——替你把請求送到 Gemini 模型。

API 在 Google AI Studio 裡管理,背後是一個 Google Cloud 專案。Google 的文件寫明,每一把 Gemini API 金鑰都關聯到一個 Google Cloud 專案,計費、協作者和權限都在專案上管理。速率限制按專案套用,不是按金鑰。付費 API 用量的開通方式,是把 Cloud 帳單帳戶連到那個專案,所以別假設消費端的 Google AI 方案會替 API 請求付錢。

第一步:建立 Gemini API 金鑰

建立金鑰只要一分鐘,免費層不需要信用卡。如果你是第一次用 AI Studio,接受服務條款之後,它會自動幫你建好預設的 Google Cloud 專案和一把 API 金鑰。

  • 到 aistudio.google.com/apikey,用你的 Google 帳戶登入。
  • 被要求時接受服務條款;新使用者會自動拿到預設專案和金鑰。
  • 建立一把 API 金鑰,或複製已建好的那把,並記下它屬於哪個專案。
  • 把金鑰存在安全的地方,例如密碼管理器。Gemini 的金鑰通常以「AIza」開頭。

第二步:在免費層和付費層之間做決定

用 Gemini 時最要緊的決定就是這個,因為兩層的差別不只在價格。定價頁為每個模型標明免費層是「Free of charge」還是「Not available」,也寫了你的內容在每一層怎麼被處理。

免費層方面,Google 的定價頁說內容會被用來改進它的產品;付費層則說內容不會被用來改進產品。如果你打算貼任何個人或機密內容,這個差別就是連結帳單的理由,就算你的用量根本在免費限額之內。

速率限制也不同。沒連帳單的專案在免費層。連上一個有效的帳單帳戶就升到 Tier 1,更高的級別隨累積消費而來。限制因模型而異,Google 也註明限制顯示在 AI Studio 裡,隨你的級別自動更新。

第二步:在免費層和付費層之間做決定
免費層付費層(已連結帳單)
每 token 費用標為「Free of charge」的模型不收費按公示的 token 單價
模型可用性許多模型,含 Flash;部分 Pro 預覽版不開放清單上全部模型
內容用途(依 Google 定價頁)用來改進 Google 的產品不用來改進 Google 的產品
速率限制免費層限制,按專案計Tier 1 起跳,按專案計

付費層上 Gemini 要多少錢

下表是截至 2026 年 9 月 28 日 Google 對三個現行模型公示的付費層價格(200,000 token 以內的提示),以及一則典型聊天訊息——2,000 輸入 token、600 輸出 token——的預估費用。注意 Gemini 3.8 Flash 帶日期的價格:Google 公示 $0.75 輸入、$3.75 輸出,到 2026 年 12 月 31 日為止;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 要多少錢
模型輸入(USD / 1M tokens)輸出(USD / 1M tokens)免費層每則典型訊息預估
Gemini 2.5 Flash-Lite0.100.40Free of charge約 $0.0004
Gemini 3.8 Flash0.75(2027 年 1 月 1 日起 1.50)3.75(2027 年 1 月 1 日起 7.50)Free of charge約 $0.004
Gemini 3.1 Pro Preview2.0012.00Not available約 $0.011

第三步:把金鑰加進 Oriveo

Oriveo 是給 iPhone、Android 和網頁用的多模型聊天 App,跑在你自己的金鑰上。Google Gemini 是它 15 家官方供應商之一,列在 Direct AI Providers 底下。下面的標籤是 App 顯示的英文原文。

按繼續時,Oriveo 向 Google 查詢這把金鑰能存取的模型來驗證金鑰,然後同步那份清單。被 Google 拒絕的金鑰會立刻回報,你可以在開聊之前修正。

第三步:把金鑰加進 Oriveo
步驟iPhoneAndroidWeb
打開供應商清單Providers 分頁Providers 分頁側欄的 Providers
開始設定Add ProviderAdd ProviderAdd Provider
選擇供應商Direct AI Providers 底下的 Google GeminiDirect AI Providers 底下的 Google GeminiDirect AI Providers 底下的 Google Gemini
貼上金鑰「Connect Google Gemini」底下的 API 金鑰欄位「Connect Google Gemini」底下的 API 金鑰欄位金鑰欄位;「Get your key at Google Gemini」連到 AI Studio
確認ContinueContinueContinue

第四步:選模型,開聊

接上之後,Gemini 的模型出現在模型選擇器裡。Flash 模型快又便宜,涵蓋大部分日常聊天;Pro 模型留給更難的推理和更長的分析。如果你的金鑰在免費層,就用定價頁標為免費的模型,因為只有付費的模型在沒有帳單時會回報錯誤。

對話中途可以換模型,包括換成你接過的其他供應商的模型,同一段對話繼續。每則訊息都按 Google 公示價格顯示預估費用;在免費層上記住,免費模型的實際費用是零,真正管住你的是速率限制。

常見錯誤,以及它們的意思

Gemini 的錯誤訊息通常具體到能指向原因。

  • 「API 金鑰 not valid」:金鑰複製得不完整、已刪除,或被加了限制。回 AI Studio 重新複製,或另建一把。
  • 速率限制或 resource exhausted:你碰到專案對該模型的每分鐘或每日上限。等一下、換模型,或連結帳單換更高限制。
  • 模型在你的層級不可用:有些模型只有付費版。把帳單連到專案,或改用標為免費的模型。
  • 好幾把金鑰一起碰到限制:限制按專案計,同一個專案裡的金鑰共用。

保管好你的金鑰

連結帳單之後,一把 Gemini 金鑰能花錢;在那之前,它也能耗光你的免費額度。Oriveo 把供應商金鑰留在你的裝置或瀏覽器裡,不存成帳戶紀錄。iPhone 和 Android App 把請求直接送到 Google;網頁版 App 走一個即時轉送端點,不保留金鑰,也不保留 BYOK 聊天內容。Oriveo 不在 Google 的價格上加價。

為聊天 App 用一個專門的專案或金鑰,在 AI Studio 和 Cloud 主控台檢查用量,任何暴露過的金鑰一律刪除。

常見問題

Gemini API 是免費的嗎?
一部分是。許多 Gemini 模型有免費層,在速率限制內不收費,但有些模型,例如 Gemini 3.1 Pro Preview,只有付費版。Google 的定價頁也寫了:免費層的內容會被用來改進產品,付費層的不會。
Gemini API 金鑰要去哪裡拿?
在 Google AI Studio(aistudio.google.com/apikey)。新使用者接受條款後會拿到預設的 Google Cloud 專案和金鑰。每把金鑰都屬於一個 Cloud 專案,計費和速率限制都在專案上。
我的 Google AI Pro 訂閱涵蓋 Gemini API 用量嗎?
別假設涵蓋。消費端的 Google AI 方案管的是 Gemini App;付費的 Gemini API 用量,要靠把 Cloud 帳單帳戶連到金鑰所屬的專案。到 AI Studio 檢查專案的帳單狀態。
用自己的金鑰使用 Gemini 要多少錢?
付費層方面,截至 2026 年 9 月 28 日,Gemini 3.8 Flash 到 2026 年 12 月 31 日止是每百萬輸入 token $0.75、每百萬輸出 token $3.75,一則典型聊天訊息預估約 $0.004。
Gemini API 金鑰可以用在 iPhone 和 Android 上嗎?
可以。在 Oriveo 打開 Providers,點 Add Provider,選 Google Gemini,貼上金鑰後繼續。原生 App 直接把請求送到 Google,同一把金鑰在網頁版也能用。

延伸閱讀

用自己的金鑰使用 Gemini

把你的 Gemini 金鑰加進 iPhone、Android 或網頁上的 Oriveo,在 Gemini 和 700+ 個模型之間切換,每一則訊息都看得到預估費用。