Gemini 2.5 Pro 上手指南：搜尋、創作與資料分析實戰 - Toolsify AI Blog

與 Gemini 2.5 Pro 共度的第一個小時

如果你有 60 分鐘，想從零到跑通 Gemini 2.5 Pro 整合，這篇指南適合你。過去兩個月我在工作坊和 Meetup 中帶約 300 位開發者走完了這個過程，最有效的模式是：先跑通，再理解。

第一步：取得 API 金鑰（5 分鐘）

前往 Google AI Studio（aistudio.google.com）。用 Google 帳號登入後，點擊左側欄「Get API Key」，再點「Create API Key」。

幾個容易踩的坑：免費層提供每分鐘 60 次 Gemini 2.5 Pro 請求，開發階段夠用。把 API 金鑰存到環境變數裡，不要寫在程式碼中：

GEMINI_API_KEY=your_key_here

把 .env 加到 .gitignore。上個月我親眼見過三個開發者把金鑰推到了公開倉庫。

第二步：第一次 API 呼叫（10 分鐘）

安裝 SDK：

npm install @google/genai

第一個腳本：

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

const response = await ai.models.generateContent({
  model: "gemini-2.5-pro",
  contents: "用兩段話解釋 REST 和 GraphQL 的差異。",
});

console.log(response.text);

用 node --env-file=.env index.mjs 執行，大約 2-4 秒出結果。Token 費用：輸入 $1.25/百萬 token，輸出 $5/百萬 token。典型查詢約 $0.001/次。

第三步：建構文件分析器（25 分鐘）

做點真正有用的。建立一個工具：接收 PDF，擷取內容，生成結構化摘要。使用 responseMimeType: "application/json" 強制結構化輸出，確保回傳合法 JSON。

第四步：新增搜尋增強（10 分鐘）

Gemini 2.5 Pro 的亮點之一是 Google Search grounding——用即時搜尋結果增強回覆。搜尋增強會增加 1-3 秒延遲，且並非所有地區都可用。

第五步：錯誤處理與速率限制（10 分鐘）

用指數退避處理 429 限流，用線性退避處理 500/503 服務錯誤。SDK 不自帶重試邏輯，需要自己實作。

接下來可以做什麼

三個專案想法：會議紀要摘要器、截圖轉程式碼工具、內容品質分析器。Gemini 2.5 Pro API 在 2026 年 3 月已經夠穩定用於生產環境，價格也很有競爭力。不要過度思考，直接開始建構。