Google AI Studio 怎麼用？從第一個 Prompt 到 Gemini API 的新手教學

用官方文件學會 Google AI Studio 的第一個 Chat prompt、Run settings、Build mode、Get code 與金鑰安全。

Google AI Studio 怎麼用？從第一個 Prompt 到 Gemini API 的新手教學

Google AI Studio 適合拿來做兩件事：先在瀏覽器裡快速試模型和 prompt，再把驗證過的想法透過 Get code 延伸成 Gemini API 程式。很多人搜尋 google studio ai 或 gemini ai studio 時，會把 AI Studio、Gemini 聊天介面和 API 混在一起；本文會先拆開三者，再用一個最小流程帶你完成第一次測試。內容依 Google 官方文件查核至 2026-09-21，介面文字可能隨版本更新。

1. Google AI Studio 是什麼？

Google AI Studio 是用來快速試用模型、設計 prompt 和建立原型的開發介面。官方 quickstart 的核心流程是：開啟 AI Studio，建立 prompt，反覆測試，再用 Get code 取得偏好的程式語言範例，接到 Gemini API。

三個名詞可以這樣分：

• Google AI Studio：用瀏覽器試 prompt、調整設定、建立或分享原型的工作台。
• Gemini 模型：實際產生文字、圖片、音訊或其他輸出的模型；不同模型的能力和輸入輸出格式不同。
• Gemini API：把在 AI Studio 驗證過的流程放進自己的網站、服務或腳本時使用的程式介面。

所以，先在 AI Studio 裡測出一個穩定 prompt，不等於你的後端已經完成；要進入應用程式，還需要用 Get code、設定金鑰、確認模型和處理錯誤。

如果你想先理解 API 串接的基本概念，可以延伸閱讀站內的AI API 新手指南；如果關心不同 Gemini model 的價格和版本，再看Gemini API 費用與免費額度整理。本文不重複列價格。

2. 第一次在 AI Studio 測試聊天 Prompt

官方 quickstart 以 Chat prompt 為例。新手可以用下面的步驟：

1. 開啟 Google AI Studio，進入新的 chat prompt。
2. 在 Run settings 中找到 System Instructions，先寫角色、任務、輸出格式和限制。
3. 在輸入框提出一個容易核對的問題，按 Run 取得結果。
4. 只修改一個條件，再送出同一個問題，觀察答案哪裡改變。
5. 確認輸出穩定後，保存 prompt 或按 Get code 繼續開發。

例如，不要一開始就要求「建立完整客服系統」，可以先測試：

你是產品文件助理。
請把使用者輸入整理成三欄：問題、已知資訊、需要追問的事項。
如果資料不足，請明確寫出「需要追問」，不要自行補造事實。

接著輸入一段短文字，看模型是否遵守三欄格式。這個例子先測「是否能穩定遵守格式」，比一開始追求長篇答案更容易定位問題。

3. Run settings 裡的功能怎麼選？

官方文件列出 Run settings 可調整模型參數和安全設定，也可以視介面與模型支援情況開啟 structured output、function calling、code execution 和 grounding 等工具。

可以用這個順序理解：

• System Instructions：定義角色、任務、語氣、格式和不能做什麼。
• 模型參數：控制輸出風格或隨機性；先保持簡單，等你有可比較的測試題再調整。
• Structured output：需要固定 JSON 或欄位時使用，但仍要在程式端驗證格式。
• Function calling：模型需要要求你的程式執行查詢或動作時使用；函式本身的權限與輸入驗證仍由你的程式負責。
• Code execution、grounding：只有在任務真的需要計算、執行程式或外部資料時開啟，並記錄輸入與結果來源。

每個模型能用的功能不一定相同；本文沒有逐一核對每個帳號、每個模型在當天介面的所有開關，這部分標為未驗證。不要因為某個教學畫面有按鈕，就推定你的模型一定支援該能力。

4. AI Studio Build mode 怎麼用？

除了聊天 prompt，官方也提供 AI Studio Build mode 的文件。你可以用自然語言描述要做的應用，讓系統產生檔案和可預覽的 app，再逐步補充功能。這適合把「想法」先做成可以點擊的原型，例如表單、簡單的資料整理工具或互動頁面。

比較穩妥的使用方式是：

1. 先說清楚使用者、主要流程和不需要做的範圍。
2. 要求先建立最小可跑版本，不要一次加入登入、付款、資料庫和所有整合。
3. 在 live preview 中逐項測試，記下錯誤和重現步驟。
4. 需要外部 API 或秘密資料時，使用 Secrets 設定與 server-side code，不要把金鑰放在瀏覽器程式碼。
5. 要部署或分享前，先查看產生的檔案、依賴套件、權限和 API 呼叫。

官方 Build mode 文件說明，AI Studio 可以把 Gemini API key 設成 server-side secret，也可以匯出或部署應用；但部署到外部環境後的權限、費用和資料處理，仍須由你自己的專案設定負責。

5. 從原型走到 Gemini API，要注意什麼？

當 prompt 在 AI Studio 裡已經有可接受結果，按 Get code 取得程式範例，再做以下檢查：

• 你使用的 model id 是否仍出現在官方模型文件與實際公開模型清單。
• API key 是否放在環境變數或 secret manager，而不是硬編碼在前端或 Git。
• 你的後端是否驗證輸入、限制輸出長度、處理逾時與錯誤。
• 需要 JSON、函式呼叫或工具時，是否在伺服器端再次驗證模型輸出。
• 是否記錄足夠的 request id、模型 ID 和結果狀態，方便日後排查。

Google 官方 API key 文件建議使用 GEMINI_API_KEY 或 GOOGLE_API_KEY 環境變數，並明確提醒不要把 key 暴露在生產環境的客戶端程式。本文只使用環境變數名稱，不放任何實際金鑰。若你看到舊範例把 key 直接寫在瀏覽器程式碼，應先改成後端或安全的 secret 管理方式。

6. BazaarLink 目前查到哪些 Gemini model id？

本文動筆前於 2026-09-21 查詢 https://bazaarlink.ai/api/v1/models。公開清單中查到 gemini-2.5-flash、gemini-2.5-pro、gemini-3.8-flash，也查到圖片相關的 gemini-2.5-flash-image、gemini-3.1-flash-image 和 gemini-3-pro-image。這些是當次公開清單中實際出現的 ID；不代表每個帳號、每種 API 格式或每項多模態能力都已逐一驗證。

如果你已在 AI Studio 驗證 prompt，下一步是先確認你的程式介面和目標 gateway 都支援相同的輸入輸出格式，再選用清單中當下仍存在的 model id。不要把 AI Studio 的顯示名稱直接當成任何第三方端點的 ID，也不要把本文列出的 ID 永久寫死在產品文件裡。

官方查證來源（查核日：2026-09-21）

• Google AI for Developers：Google AI Studio quickstart
• Google AI for Developers：Build apps in Google AI Studio
• Google AI for Developers：Using Gemini API keys
• Google AI for Developers：Gemini API models
• BazaarLink 公開模型清單

未驗證項目： 個別帳號、地區與模型在 AI Studio 當天顯示的全部功能開關；AI Studio 原型部署到外部環境後的個別權限、配額與計費狀態；上述 model id 在你所選 API 格式下的完整多模態能力。本文沒有引用價格。

台幣計費・統一發票・主流 AI 模型・OpenAI 相容 API