Gemini API 入門:從 AI Studio 測試到第一個企業工作流程

先在 AI Studio 把任務試清楚,再接成 API。能回答問題,和能穩定接進企業流程,是兩個不同階段。

你可能已經用 Gemini 寫過文案,接著想把同樣能力放進網站或自動化工具。這時候需要理解的不只是 API key 怎麼取得,還包括它屬於哪個專案、資料適用什麼條件,以及成本怎麼追蹤。

這篇以一個「把公開產品介紹整理成摘要」的小任務為例,帶你走過入門順序。範例不使用真實客戶資料,也不承諾任何固定費用或產量。

先分清楚三個入口

Gemini 應用程式供使用者直接互動。Google AI Studio供開發與測試模型能力。Gemini API則讓程式或其他工具送出請求、接收結果。

不要因為已購買某個 Google AI 個人方案,就自行假設所有 API 使用都包含在裡面。API 專案、帳務與適用優惠應在 AI Studio 和相關帳務設定確認。Google API 入門文件

Gemini 應用程式、AI Studio 與 API 三個入口的分工
不要因為買了某個 Google AI 個人方案,就假設所有 API 使用都包含在裡面。

第一步:在 AI Studio 做出可以驗收的提示詞

進入 Google AI Studio,使用自己有權使用的帳號,選擇畫面可用的模型。先貼一小段公開產品資訊,要求輸出固定欄位:產品用途、適用對象、已提供的限制,以及資料缺口。

可以從這段開始:

你是產品資料整理助理。請只根據提供的介紹,整理「用途、對象、限制、缺少資訊」四個欄位。沒有提到的內容寫「未提供」。不得補上價格、客戶名稱或成效數字。

先確認結果正確,再換另一段材料測一次。若資料稍微變化就無法穩定輸出,先改善需求與驗收,暫時不要接成自動執行流程。

Gemini API 從測試到串接的四個步驟
能回答問題,和能穩定接進企業流程,是兩個不同階段。

第二步:建立 API key,確認它的專案

依 AI Studio 的 API key 入口建立或選擇專案,再取得對應金鑰。金鑰交給服務執行環境保存,不放進公開網頁或共用範例。

團隊紀錄要能回答:這把金鑰服務哪個流程、誰負責、哪個專案付費,以及停用時會影響什麼。網站前端若直接內嵌金鑰,其他人可能取得並使用;應由適當的後端服務處理請求與權限。

第三步:用官方 SDK 做最小測試

Google 官方目前建議使用 Google GenAI SDK。以下只示範基本文字產出,模型請選擇帳號當下可用、且已確認計價的項目;不要把舊教學中的模型名稱當成永久有效。SDK 遷移與使用說明

安裝 Python 套件:

python -m pip install -U google-genai

在執行環境設定 GEMINI_API_KEY 與 GEMINI_MODEL 後,可以用下列範例呼叫。GEMINI_MODEL 填入你在 AI Studio 確認可用的模型名稱;金鑰不要寫進這個檔案。

import os
from google import genai

client = genai.Client(api_key=os.environ['GEMINI_API_KEY'])
response = client.models.generate_content(
    model=os.environ['GEMINI_MODEL'],
    contents='請把這段自製範例整理成一句話:本產品用於整理公開活動資訊。'
)
print(response.text)

範例需在已完成金鑰與模型設定的環境中執行。第一次只送一筆資料,確認回應與用量都可查,再串接其他工具。

免費與付費,除了金額也有資料條件

不要把「Google 產品」當成單一資料政策。Gemini API 條款區分免費與付費服務;免費服務條款說明內容可能用於改善產品與模型,也要求不要提交敏感、機密或個人資訊。Gemini API 條款

要處理公司資料時,請 IT 核對實際專案、帳務狀態、地區與適用條款。支付費用,也不會自動完成公司的資料授權程序。

另外,官方帳務文件指出,Gemini API 使用不適用一般 Google Cloud 的 US$300 免費試用方案。若有人說「開 Cloud 帳號就有三百美元可以隨便跑 Gemini」,請回到 API 帳務文件核對。Gemini API 帳務說明

從測試走到正式流程,還要補什麼?

先定義輸入格式與可接受的輸出,再處理例外:資料空白怎麼辦、結果缺欄位怎麼辦、請求失敗要不要重試,以及何時轉人工。

測試紀錄至少留下模型、時間、成功與失敗數、用量與人工修正情況。注意不要把完整敏感資料留進一般除錯紀錄。當你能解釋錯誤從哪裡來,才有能力穩定改善流程。

阿峰觀點:API 的價值,在於工作可以重複完成

第一個目標不用太大。先讓一筆公開資料正確進來、一份合格結果出去,而且出錯時有人知道怎麼處理。這樣的流程才適合擴大。

你是機長,AI 是機組人員;流程出錯時,要有人知道怎麼接手。

還在判斷要買訂閱還是串接,可先看 AI 訂閱與 API 的選擇方式。想從部門需求規劃第一個可驗收的流程,可透過 企業 AI 培訓諮詢 說明目前的重複工作。

延伸閱讀:OpenAI API 開通與儲值教學:從第一筆測試到企業用量管理、Gemini 費用怎麼選?Google AI Plus、Pro、Ultra 與 Workspace 採購指南、Gemini 模型怎麼選?Flash、Pro 與思考設定的工作驗收指南。


作者:黃敬峰(AI峰哥/阿峰老師)|企業 AI 實戰培訓專家。

資料查核:2026 年 9 月 11 日。產品功能、方案與操作介面若有調整,請以文內官方來源及你的帳號畫面為準。

常見問題

有 Google AI 訂閱,Gemini API 就一定免費嗎?

不能直接推論。請在 AI Studio 核對 API 專案的方案、帳務與適用優惠。

Google Cloud 的三百美元試用可以用在 Gemini API 嗎?

本文查核的 Gemini API 官方帳務文件明確排除一般 US$300 Cloud 免費試用。其他優惠也要逐項確認適用範圍。

Gemini API 金鑰可以直接放網頁嗎?

不要把私密金鑰放在公開前端。應由適當的後端與祕密管理機制保存並使用。