Google AI Studio 教學：免費 AI 開發平台完整指南

這篇 Google AI Studio 教學逐句對照 Google 官方文件（ai.google.dev 與 aistudio.google.com）整理，涵蓋 AI Studio 能做什麼、免費與付費的差別、在網頁上試第一個提示詞、取得 API 金鑰，以及用 Python 發出第一次 Gemini API 測試。內容核對日期為 2026 年 9 月 30 日；當時官方文件範例使用的模型是 Gemini 3.8 Flash（gemini-3.8-flash），Python SDK google-genai 在 PyPI 上的最新版本是 2.25.0。

Google AI Studio 是什麼？

Google AI Studio 是 Google 提供的網頁工具，官方說明是讓你「快速試用模型、實驗不同提示詞」，準備好寫程式時再按 Get code 取得對應語言的 Gemini API 程式碼。它的首頁（aistudio.google.com）把自己定位成「Go from prompt to production」，列出可以試用的模型包括：

• Gemini 3：推理用的主力模型
• Nano Banana：圖片生成
• Veo：影片生成
• Gemini TTS：文字轉語音
• Gemini Live：即時語音與視訊互動
• Lyria：音樂生成

在 AI Studio 裡，你可以做三類事：

1. Playground（提示詞實驗）：打字和模型對話、調整 Run settings（模型參數、安全設定），也能開啟結構化輸出、函式呼叫、程式碼執行、Grounding 等工具。
2. 管理 API 金鑰與用量：建立 Gemini API 金鑰、查看專案、在 Dashboard > Usage 看用量。
3. Build 模式：用自然語言描述想做的應用（官方稱為 vibe coding），AI Studio 會生成完整的網頁應用（預設前端 React、後端 Node.js），或 Kotlin＋Jetpack Compose 的 Android 應用，右側即時預覽。

事前準備：帳號、地區與年齡

• Google 帳號：用 Google 帳號登入 aistudio.google.com 即可。
• 地區：官方「Available regions」清單包含台灣。若所在地區不支援，開啟 AI Studio 會看到 403 Access Restricted。
• 年齡：Gemini API 服務條款規定使用者須年滿 18 歲，也不能把它用在以未滿 18 歲族群為對象的服務。

免費還是付費？先看清楚這張表

官方定價頁把方案分成 Free、Paid、Enterprise 三種。直接在 Google AI Studio 網頁上使用是免費的（定價頁註明：Google AI Studio usage is free of charge in all available regions），除非你把付費專案的 API 金鑰連進 AI Studio 使用付費功能。

| | Free（免費層） | Paid（付費層） |

|---|---|---|

| 可用模型 | 部分模型 | 含 Google 最進階的模型 |

| 輸入／輸出 token | 免費 | 依模型計價（見下方） |

| 速率限制 | 免費層限制 | 較高，依用量等級提升 |

| Batch API | — | 有（費用減 50%） |

| 你的內容會不會拿去改進 Google 產品 | 會 | 不會 |

免費層的資料用途要特別注意：服務條款寫明，使用免費服務（包括 Google AI Studio 與 Gemini API 免費額度）時，Google 會用你送出的內容與生成結果來改進產品與機器學習技術，而且可能有人工審查員閱讀、標註你的輸入與輸出（會先與帳號、金鑰、專案脫鉤）。官方原話是：不要把敏感、機密或個人資訊送進免費服務。

免費層每分鐘／每天能呼叫幾次，官方文件沒有列固定數字，而是說明限制依模型與用量等級而定、以 AI Studio 裡顯示的為準（在 AI Studio 可查看目前的 rate limit）。限制按專案計算，不是按金鑰；每日請求數（RPD）在太平洋時間午夜重置。

付費價格舉例（每 100 萬 token，美元）

以下取自官方定價頁（2026 年 9 月 24 日更新版），免費層這兩個模型的輸入輸出都標示「Free of charge」：

| 模型 | 輸入 | 輸出（含 thinking token） |

|---|---|---|

| Gemini 3.8 Flash（gemini-3.8-flash） | $0.75（至 2026/12/31），2027/1/1 起 $1.50 | $3.75（至 2026/12/31），2027/1/1 起 $7.50 |

| Gemini 3.5 Flash-Lite（gemini-3.5-flash-lite） | $0.30 | $2.50 |

升級付費層要做什麼

1. 在 AI Studio 的 API keys 或 Projects 頁面按 Set up billing。
2. 依 Cloud Billing 對話框建立或連結帳單帳戶、加入付款方式，並預付至少 US$5（或等值貨幣）的點數。
3. 預付點數最高可買 US$5,000，未用完的點數 12 個月後到期、不退款。點數歸零時，該帳單帳戶底下所有專案的金鑰會同時停用，請求回傳 HTTP 402。
4. 用量在 Dashboard > Usage 查看。

另外兩點官方有特別寫：Google Cloud 新帳戶的 US$300 Welcome credit，若帳戶是 2026 年 3 月 2 日之後開的，不能用來付 Gemini API 與 AI Studio 的費用；想退回免費層，把專案的帳單停用即可。

Step 1：在 AI Studio 試第一個提示詞

以下步驟依官方「Google AI Studio quickstart」的聊天機器人範例：

1. 打開 aistudio.google.com，用 Google 帳號登入。預設會開啟 Playground，裡面是一個新的聊天提示詞。
2. 點右上角的 Run settings（調整圖示）展開面板，找到 System Instructions 欄位，貼上角色設定，例如：

   你是一位住在木衛二（Europa）上的外星人。

1. 在標示 Type something... 的輸入框打一個問題，例如「那裡的天氣怎麼樣？」
2. 按 Run，模型就會以外星人的口吻回答。
3. 想讓回答更一致，就把 System Instructions 寫得更具體，例如加上「回答不超過 3 段，語氣輕快」。System Instructions 在對話開始後仍可修改，改完重新按 Run 看差異。
4. 滿意之後，按 Get code 選擇程式語言，就能拿到可以直接用 Gemini API 重現的程式碼；也可以把提示詞存起來，之後再改或分享給別人。

官方提醒：聊天時每一則訊息都會被放進提示詞裡，對話愈長提示詞愈長，最後可能碰到模型的 token 上限。畫面底部的 Text Preview 按鈕會顯示目前提示詞用掉的 token 數與模型上限。

關於 Temperature：官方建議不要亂調

很多舊教學會叫你「要精確就把 Temperature 調到 0.2」。Gemini API 官方疑難排解文件的說法相反：temperature、top_p、top_k 雖然可以改，但對 Gemini 3.x 模型強烈建議維持預設值；把 temperature 調到 1.0 以下，可能造成輸出無限重複（looping）或品質下降，在數學與推理類任務特別明顯。想控制回答風格，優先改 System Instructions。

Step 2：取得 Gemini API 金鑰

1. 新使用者：第一次進 AI Studio 並接受服務條款後，AI Studio 會自動建立一個預設的 Google Cloud 專案和 API 金鑰，到 API keys 頁面就能複製。
2. 需要新金鑰：在 API keys 頁面按 Create API key，照對話框建立金鑰與專案的組合。
3. 已經有 Google Cloud 帳戶：AI Studio 不會自動建預設專案，要先匯入：左側打開 Dashboard → Projects → Import projects → 搜尋並選取專案 → Import，再回 API Keys 頁建立金鑰。
4. 如果 Create API key 按鈕不能按、顯示「You do not have permission to create a key in this project」，代表你在該專案沒有足夠的 IAM 權限（例如需要 Project Editor 一類的角色）。拿不到權限的話，官方建議建一個不屬於任何組織的新 Google Cloud 專案來產生金鑰。

2026 年 5 月 28 日起，AI Studio 新建立的金鑰一律是 auth key（綁定 Google Cloud 服務帳戶）；沒有設限制的舊式 standard key 會被 Gemini API 拒絕。舊金鑰在 API Keys 頁若標示 Unrestricted，可以滑到標籤上按 Add restrictions → Restrict to Gemini API only → Restrict key。

金鑰安全：官方的三條規則

• 不要把金鑰提交到 Git 等版本控制系統。
• 不要把金鑰寫死在網頁或手機 App 的程式碼裡，使用者可以從前端程式碼取出金鑰；要在後端（官方稱 backend proxy server）呼叫 API。
• 金鑰外洩時：先在 AI Studio 產生新金鑰 → 更新應用程式 → 新金鑰確認可用後，再停用或刪除舊金鑰 → 到 Google Cloud Console 檢查帳單與用量紀錄。

Step 3：用 Python 發出第一次 Gemini API 呼叫

官方目前推薦的 SDK 是 Google GenAI SDK（Python 套件名 google-genai，2025 年 5 月起正式 GA），支援 Python、JavaScript/TypeScript、Go、Java。舊的 google-generativeai 已在 2025 年 11 月 30 日停止維護，新專案不要再用。

1. 設定環境變數（macOS／Linux 範例）：

   export GEMINI_API_KEY="你的 API 金鑰"

SDK 會自動讀取 GEMINI_API_KEY 或 GOOGLE_API_KEY；兩個都有設時，GOOGLE_API_KEY 優先。

1. 安裝 SDK（PyPI 上 2.25.0 版需要 Python 3.10 以上）：

   pip install -U google-genai

1. 建立 hello.py，貼上官方範例：

   from google import genai

   client = genai.Client()

   interaction = client.interactions.create(
       model="gemini-3.8-flash",
       input="Explain how AI works in a few words"
   )
   print(interaction.output_text)

1. 執行 python hello.py，終端機印出一段簡短說明，就代表 API 金鑰、SDK、網路都通了。

這個範例用的是官方文件目前標示為推薦的 Interactions API（client.interactions.create）。同一份入門文件接著示範串流輸出（stream=True）、多輪對話（傳入 previous_interaction_id 由伺服器保存對話歷史）、上傳圖片與音訊一起分析，以及結構化輸出，照順序往下做即可。

常見錯誤與排除

• 429 RESOURCE_EXHAUSTED：超過速率限制（RPM、TPM、RPD 任一項超過就會觸發）。官方建議指數退避重試（例如等 1 秒、2 秒、4 秒、8 秒）並加入隨機抖動；Python SDK 預設就會對 429 與 5xx 自動重試最多 4 次。
• 400、402、403 不要重試：這類錯誤代表請求本身有問題，例如金鑰無效、預付點數用完（402）或參數錯誤，重試也不會成功。
• 403 Access Restricted（開 AI Studio 時）：常見原因是所在地區不在支援清單內。
• AI Studio 顯示 No Content：內容因某種原因被擋。把游標移到 No Content 上、點 Safety 可以看詳細原因；若是安全設定擋的，評估風險後可調整安全設定。
• 回應很慢、token 用量比預期多：Gemini 3.x 模型預設開啟 thinking（思考），會產生額外的推理 token。在意延遲或成本時，可以調低 thinking level。
• 舊金鑰突然失效：2026 年 5 月 7 日起，長期沒用、又沒設限制的金鑰會被封鎖，在 AI Studio 會看到 Blocked 標籤，要重新產生金鑰。

常見問題 FAQ

Google AI Studio 免費嗎？

直接在 AI Studio 網頁上使用是免費的，官方定價頁寫明在所有支援地區都免費。Gemini API 也有免費層，部分模型（例如 Gemini 3.8 Flash、Gemini 3.5 Flash-Lite）的輸入輸出標示免費，但有速率限制，而且免費層的內容會被用來改進 Google 產品。

Google AI Studio 在台灣可以用嗎？

可以。官方「Available regions for Google AI Studio and Gemini API」清單包含台灣。

免費層一天可以呼叫幾次？

官方文件沒有公布固定數字，限制依模型和用量等級不同，要以 AI Studio 裡顯示的 rate limit 為準。限制以專案計算，每日額度在太平洋時間午夜重置。

升級付費要多少錢？

在 AI Studio 按 Set up billing 連結帳單帳戶，並預付至少 US$5 的點數；之後依模型的 token 單價扣款。Google Cloud 新帳戶的 US$300 Welcome credit（2026 年 3 月 2 日後開的帳戶）不能用來付 Gemini API 費用。

為什麼我把 Temperature 調低，輸出反而一直重複？

官方文件說明，Gemini 3.x 模型把 temperature 調到 1.0 以下可能造成無限重複或品質下降，建議維持預設值，改用 System Instructions 控制回答風格。

API 金鑰可以放在前端網頁嗎？

不行。官方規定不要把金鑰寫死在網頁或手機 App 裡，要透過後端伺服器呼叫 API，並用環境變數或 Google Cloud Secret Manager 保管金鑰。

資料來源

本文事實依據以下官方頁面，核對日期 2026 年 9 月 30 日：

• Google AI Studio 首頁：https://aistudio.google.com/
• Google AI Studio quickstart：https://ai.google.dev/gemini-api/docs/ai-studio-quickstart
• Gemini API Getting started：https://ai.google.dev/gemini-api/docs/quickstart
• Using Gemini API keys：https://ai.google.dev/gemini-api/docs/api-key
• Gemini Developer API pricing：https://ai.google.dev/gemini-api/docs/pricing
• Billing：https://ai.google.dev/gemini-api/docs/billing
• Rate limits：https://ai.google.dev/gemini-api/docs/rate-limits
• Available regions：https://ai.google.dev/gemini-api/docs/available-regions
• Gemini API libraries：https://ai.google.dev/gemini-api/docs/libraries
• Troubleshooting guide：https://ai.google.dev/gemini-api/docs/troubleshooting
• Troubleshoot Google AI Studio：https://ai.google.dev/gemini-api/docs/troubleshoot-ai-studio
• Build apps in Google AI Studio：https://ai.google.dev/gemini-api/docs/aistudio-build-mode
• Gemini API Additional Terms of Service：https://ai.google.dev/gemini-api/terms
• PyPI：google-genai：https://pypi.org/project/google-genai/

價格、免費額度、模型與介面由 Google 隨時調整，實際內容請以上列頁面當下顯示為準。