一句話重點

到 aistudio.google.com 用 Google 帳號登入、接受服務條款，新使用者就會自動拿到一組免費的 Gemini API key，複製下來就能用。照官方快速入門的說明，第一次呼叫 API 不到一分鐘就能完成。免費額度可以用 Gemini 4 Hydrogen，代價是免費方案的內容 Google 會拿來改進產品。

如果你還不熟 AI Studio 本身，可以先看 Google AI Studio 完整教學。這篇只講 API key。

免費嗎？

免費。Google 的定價頁寫得很清楚，免費方案的輸入和輸出 token（AI 計算文字量的單位）都不收錢，AI Studio 本身在所有支援地區也都免費。台灣在官方支援地區名單裡，可以直接申請。

免費方案有兩個限制：

  • 速率限制比較低：每分鐘請求數（RPM）、每分鐘輸入 token 數（TPM）、每天請求數（RPD）都有上限，超過任何一項就會回傳錯誤。每天的額度在美國太平洋時間午夜重置。
  • 只開放部分模型：Gemini 4 Hydrogen、Gemini 3.8 Flash 等有免費額度，Gemini 4 Argon、Gemini 4 Carbon 和 Nano Banana 圖片模型就只有付費方案能用。

另外，使用 API 必須年滿 18 歲。

怎麼申請？

  1. 打開 aistudio.google.com，用 Google 帳號登入。
  2. 第一次使用會看到服務條款，接受之後，AI Studio 會自動幫你建一個 Google Cloud 專案和一組 API key。
  3. 到 API Keys 頁面，把那組 key 複製下來。
  4. 想多要一組，點 Create API key，照對話框選好專案就會產生新的 key。
  5. 把 key 設成環境變數（下一節有指令），不要貼在程式碼裡。

本來就有 Google Cloud 帳號的人，AI Studio 不會自動建專案。做法是從左側欄打開 Dashboard，選 Projects，點 Import projects，選好專案再按 Import，接著到 API Keys 頁面建 key。

從 Google Cloud 匯入的專案或額外開的專案，有時要先做手機驗證才能用免費額度。驗證方式是用手機掃 QR code，不用給電話號碼，也不用裝 app。

申請好之後怎麼測試？

先把 key 存進環境變數。macOS、Linux 用這行：

export GEMINI_API_KEY="YOUR_API_KEY"

Windows PowerShell 用這行：

$env:GEMINI_API_KEY="YOUR_API_KEY"

官方的 SDK（軟體開發套件）會自己讀 GEMINI_API_KEY 或 GOOGLE_API_KEY，兩個都設的話，以 GOOGLE_API_KEY 為主。

接著用官方快速入門的 curl 指令試一次：

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Api-Revision: 2026-05-20" \
  -d '{
    "model": "gemini-4-hydrogen",
    "input": "Explain how AI works in a few words"
  }'

有回傳一段 JSON 回答，就代表 key 可以用了。習慣寫 Python 的人，先跑 pip install -U google-genai，再用 genai.Client() 建立 client，它會自己抓環境變數裡的 key。

免費和付費差在哪？

免費方案付費方案
費用輸入、輸出 token 都免費依 token 計費，Hydrogen 每百萬 token 輸入 1.5 美元、輸出 7.5 美元
速率限制較低較高，批次處理（Batch API）打五折
可用模型部分模型包含 Argon、Carbon 等旗艦模型
你的資料Google 會用來改進產品不會用來改進產品

資料用途是最大的差別。免費方案送出的內容和回覆，Google 會拿來改進產品，人工審閱員也可能讀到。服務條款直接寫明，不要把敏感、機密或個人資料送進免費方案。

升級的方式是在 API Keys 頁面點 Set up billing，連結帳單帳戶並預付至少 5 美元的額度。開了帳單的專案，API 呼叫就算付費服務，資料不會被拿去改進產品。

Key 怎麼保管、外洩怎麼辦？

官方建議把 API key 當成密碼保管。保管原則有四個：

  • 不要把 key 推上 Git 之類的版本控制。
  • 不要把 key 寫死在網頁或手機 app 裡，前端的程式碼使用者拆得出來，要透過自己的後端代為呼叫。
  • 從環境變數讀 key。正式上線的服務，改放 Google Cloud Secret Manager。
  • 在 Google Cloud console 設帳單警示，用量突然暴增時會通知你。

2026 年 5 月 28 日起，AI Studio 建立的新 key 都是 auth key，預設只能呼叫 Gemini API，Google 偵測到外洩時也能很快把它擋下。

懷疑 key 外洩時，照這個順序處理：

  1. 到 AI Studio 的 API Keys 頁面建一組新 key。
  2. 把應用程式換上新 key 並部署。
  3. 確認新 key 能用之後，到 Google Cloud console 停用或刪除外洩的 key。
  4. 檢查帳單紀錄和 API 用量，找出有沒有被盜用。

順序很重要。新 key 還沒上線就先刪舊 key，服務會中斷。

常見錯誤怎麼處理？

  • 429 RESOURCE_EXHAUSTED：官方文件寫明，碰到以花費計算的速率限制時，API 會回傳這個錯誤。速率限制是算在整個專案上，多開幾組 key 不會多出額度。官方建議用指數退避重試，也就是第一次等一下，之後每次等更久。Python SDK 預設會自動重試最多 4 次。用量本來就大，就升級付費方案。
  • 403 FREE_TIER_VERIFICATION_REQUIRED：免費方案的專案還沒做手機驗證。開啟錯誤訊息裡的驗證連結，點 Verify device，用手機相機掃 QR code，看到 Project verified 後再重試。同一個專案重開新 key 解決不了，因為驗證是看專案。不想驗證的話，也可以直接開帳單改用付費方案。
  • 其他 403 PERMISSION_DENIED：錯誤訊息是 Your project has been denied access，專案狀態可能顯示 Restricted、Free tier unavailable、Payment needed 或 Unavailable。顯示 Free tier unavailable 代表這個專案不能用免費方案，要連結帳單帳戶改用付費方案，重開新 key 也一樣不能用。
  • Create API key 按鈕不能按，顯示 You do not have permission to create a key in this project：你在這個專案沒有建 key 的權限。請專案管理員幫你開權限，或自己開一個不屬於任何組織的新專案。
  • 舊 key 顯示 Unrestricted 標籤：Gemini API 會拒絕沒設限制的舊式 key（standard key）。到 API Keys 頁面把滑鼠移到 Unrestricted 標籤上，點 Add restrictions，選 Restrict to Gemini API only，再按 Restrict key。
  • 舊 key 出現 Blocked 標籤：沒設限制的舊 key 放太久沒用，會被封鎖。改用一組有設限制的 key，或在 API Keys 頁面點 Create API key 建新的。
  • 打不開 AI Studio：先確認所在地區。台灣在支援名單裡，香港和中國大陸不在。

小企鵝的總結

申請 Gemini API key 比大多數人想的簡單，新使用者登入 AI Studio、接受條款，key 就已經在 API Keys 頁面等你。免費額度可以直接試 Hydrogen。要記住的只有兩件事：key 放環境變數，不要進 Git 或前端程式碼，還有免費方案的內容會被 Google 拿去改進產品，敏感、機密或個人資料不要送進免費方案。更多 Gemini 的用法，可以回到 Gemini 系列總覽。

本文為 AI 模型 API 計費的消費資訊，不涉及證券或投資建議。本文資訊截至 2026 年 11 月 14 日。