Gemini 3.1 Pro — 深入推理程式碼與文件
Gemini 3.1 Pro 將文字、圖片、音訊、影片與 PDF 整合到同一段對話。選擇思考層級、要求結構化文字，並在應用程式呼叫工具時保留原始對話內容部分。 US$0.80 / 1M 輸入 · US$4.80 / 1M 輸出.
- 100 萬 token 輸入
- 65,536 token 輸出
- 三種思考層級
- 函式呼叫
- 多模態輸入
Playground
使用原生請求探索 Gemini 3.1 Pro。選擇帳戶分組、檢視設定，並以帳戶餘額提交請求。實際功能驗證仍待完成。
gemini-3.1-pro-preview$0.80 輸入 · $4.80 輸出，每百萬 token更多 Gemini 參數
Gemini 3.1 Pro 價格
以下 Gemini 3.1 Pro 價格取自目前的計費設定。比較可用帳戶分組的輸入、輸出與快取輸入費率。未快取輸入超過 200,000 token 的請求適用長上下文級距。
範例用量僅供說明。實際帳單以每個請求回傳的 token 數為準。 標準處理費率。200,000 token 的門檻以未快取輸入計算。快取 token 單獨計費，不會再以未快取輸入重複計費。工具費用與快取儲存費用不包含在這些 token 範例中。
| 類別 | googlellm · ≤ 200,000 未快取輸入 token價格 · 100 萬 token | googlellm · > 200,000 未快取輸入 token價格 · 100 萬 token | googlellm-vertext · ≤ 200,000 未快取輸入 token價格 · 100 萬 token | googlellm-vertext · > 200,000 未快取輸入 token價格 · 100 萬 token |
|---|---|---|---|---|
| 輸入 | $0.80 | $1.60 | $1.00 | $2.00 |
| 輸出（含思考） | $4.80 | $7.20 | $6.00 | $9.00 |
| 快取輸入 | $0.08 | $0.16 | $0.10 | $0.20 |
只有未快取輸入決定級距。快取輸入依該級距的費率單獨計費。範例使用標準級距。
Gemini 3.1 Pro 是什麼？
Gemini 3.1 Pro 是 Google 的推理模型，可用來理解程式碼、比較文件，以及解釋跨媒體資訊。請一併提供素材、問題與預期的答案格式。
一般版 Gemini 3.1 Pro 請使用 gemini-3.1-pro-preview。Google 也記載了針對特定工具選擇需求設計的 customtools 變體。本頁串接一般版；思考深度是另一項獨立設定。
官方模型上限已於 2026 年 10 月 17 日核對。輸入與輸出各有獨立上限。
開始使用 Gemini 3.1 Pro
從具有代表性的任務開始，儲存輸入與設定以供比較。
試用 Playground
傳送 Gemini 3.1 Pro 訊息、附上佐證素材，並在送出前檢視原生 JSON 請求。官方控制項使用原生欄位名稱與型別；自訂 JSON 會原樣送出，由 Gemini API 驗證。
選擇帳戶分組
從帳戶可用的 Gemini 3.1 Pro 分組中選擇。Playground 會依選項更新費率；新增分組也會顯示在同一份依帳戶權限提供的清單中。
使用 API 參考文件
將原生 Gemini 3.1 Pro 範例複製到應用程式。參考文件列出請求欄位、回應欄位、媒體輸入，以及仍需實際驗證的功能。
Gemini 3.1 Pro 可以協助你開發什麼
先選擇輸出規格，再依來源素材核對結果。
推理程式變更
請 Gemini 3.1 Pro 跨相關函式追查錯誤、說明假設，並提出針對性的修補。接受變更前，請先執行測試。
回傳結構化資料
提供 JSON 回應 schema，讓 Gemini 3.1 Pro 擷取或分類資料。請依文件核對回傳值；JSON 格式有效本身並不代表事實正確。
搭配自有函式
宣告具名函式及其引數 schema。Gemini 3.1 Pro 可回傳函式呼叫，交由應用程式執行；允許哪些動作由你的程式碼決定。
比較媒體與文字
將圖表、螢幕截圖或 PDF 與問題一併提供。Gemini 3.1 Pro 接受多模態輸入並回傳文字，適合依據提供的素材進行解釋。
Gemini 3.1 Pro 實用任務
以下為建議工作流程，並未宣稱任何基準測試或客戶成果。
審查程式碼庫變更
提供相關檔案與測試失敗資訊給 Gemini 3.1 Pro。要求它提出能解決失敗的最小變更，並另外說明仍未釐清的事項。
從文件擷取檢查清單
請 Gemini 3.1 Pro 將提供的文件轉為結構化檢查清單。在 schema 中加入來源位置，方便審查者核對每個擷取項目。
解釋錄製的示範
提供支援格式的短片，請 Gemini 3.1 Pro 描述特定步驟。將問題限於可見證據，並要求它指出不清楚的細節。
如何使用 Gemini 3.1 Pro
- 01
準備存取權限
登入、儲值並建立供伺服器端使用的 API 金鑰。在 Playground 中開啟 Gemini 3.1 Pro，檢視請求格式。
- 02
提供上下文
將提示詞與先前的對話放入 contents。Gemini 3.1 Pro 媒體輸入需包含正確的 MIME 類型及支援的檔案參照。
- 03
選擇思考與輸出設定
使用 low、medium 或 high 思考層級。Gemini 3.1 Pro 預設為 high；若回應長度很重要，請明確設定 maxOutputTokens。
- 04
檢查回應
讀取 candidates、finishReason 與 usageMetadata。傳送下一輪訊息時，請保留 Gemini 3.1 Pro 的思考簽章與工具部分。
原生 Gemini 3.1 Pro API
Gemini 3.1 Pro 以 generateContent 提供 JSON 回應，並以 streamGenerateContent 提供伺服器傳送事件。獨立參考文件包含可複製的範例與完整參數 schema。
使用精確模型名稱
在 URL 中使用 gemini-3.1-pro-preview。Gemini 3.1 Pro 這類顯示名稱不能直接代替 API 識別碼。
明確設定生成參數
Gemini 3.1 Pro 保留 temperature 與取樣欄位。Google 建議 temperature 使用 1.0。思考層級、輸出格式與工具仍是不同的控制項。
讀取實際用量
Gemini 3.1 Pro 的輸出用量包含思考 token。計算上下文門檻時，快取輸入仍計入總輸入量，並依快取輸入費率計價。
兩種官方 Gemini 3.1 Pro 變體
差異在於工具選擇，並非另一種推理層級。本頁僅串接一般版 Gemini 3.1 Pro 模型。
| 選項 | 一般 Preview | Customtools Preview |
|---|---|---|
| API ID | gemini-3.1-pro-preview | gemini-3.1-pro-preview-customtools |
| 文件記載的用途 | 一般推理與工具使用 | 同時可用 bash 時，優先選擇自訂工具 |
| 函式呼叫 | 支援 | 專門的工具選擇行為 |
| 評估問題 | 是否解決了實際任務？ | 是否選擇了預期的自訂工具？ |
Google 提醒，Customtools 在非預期工作流程中可能出現品質差異。此處比較的是文件內容，並非新的 A/B 基準測試。 Google 模型文件
Gemini 3.1 Pro 限制
輸入與輸出預算各自獨立
Gemini 3.1 Pro 最多接受 1,048,576 個輸入 token，並最多產生 65,536 個輸出 token。思考會使用輸出預算；簡短答案仍可能需要思考 token。
僅輸出文字
Gemini 3.1 Pro 可分析支援的媒體，但不會生成圖片或音訊。需要這些輸出時，請使用專門的生成模型。
確認進階功能
Gemini 3.1 Pro 的官方模型規格支援工具。此處仍待實際驗證媒體、快取與個別工具；接受參數並不代表其行為已獲確認。
快取資源需要存取權限
cachedContent 值會指定現有的快取資源。名稱格式正確並不代表 Gemini 3.1 Pro 就能使用該快取；仍須符合資源存取權限與模型相容性要求。
透過 SeedRouter 使用 Gemini 3.1 Pro
共用同一筆帳戶餘額
以同一筆 SeedRouter 餘額使用 Gemini 3.1 Pro，以及其他列出的文字、圖片與影片模型。請遵守各模型的請求格式與限制。
模型旁即可查看價格
在本頁確認 Gemini 3.1 Pro 的 token 費率，並選擇預計使用的帳戶分組。價格表會反映目前的計費設定。
成功請求才計費
失敗的 Gemini 3.1 Pro 請求不收費。成功請求依回報的 token 用量計費，包含思考與快取輸入。
探索其他文字模型
比較可用文字模型各自文件記載的功能與目前費率。
用 OpenAI SDK 呼叫 GPT-6 Astra。OpenAI 能力最強的模型，105 萬 token 上下文，按 token 即時計價，Playground 立即可試。
檢視價格用 OpenAI SDK 串接 GPT-6 Sol：105 萬 token 上下文視窗，推理強度可從 none 調到 max，按 token 即時計價，還有 Playground 可立即線上試用。
檢視價格用 OpenAI SDK 串接 GPT-6.1 Sol：程式開發與代理能力接近 Astra，價格僅五分之一，105 萬 token 上下文視窗，快取輸入只要 5% 費率。立即試用。
檢視價格用 OpenAI SDK 呼叫 GPT-6 Luna。GPT-6 系列價格最低的模型，105 萬 token 上下文，按 token 即時計價，Playground 線上即可試用。
檢視價格體驗 Claude Haiku 5.5 的文字分類、文件資訊擷取與摘要功能。查看即時輸入與輸出 token 價格，測試實際任務的提示詞，並透過 Messages API 將模型串接至應用程式。
檢視價格用 Claude Sonnet 5.5 審查程式碼、解答文件問題。查看即時 token 價格，在 Playground 測試提示詞並檢視回答與用量，了解已驗證的功能和相容性限制，再串接至應用程式。
檢視價格Gemini 3.1 Pro 常見問題
Gemini 3.1 Pro 應該使用哪個模型 ID？+
本頁 Gemini 3.1 Pro 使用 gemini-3.1-pro-preview。另一個 customtools 變體會在同時可用 bash 時優先選擇自訂工具。
Gemini 3.1 Pro 預設使用哪個思考層級？+
Gemini 3.1 Pro 預設為 high。支援 low 與 medium，但不支援 minimal。請勿同時設定 thinkingLevel 與 thinkingBudget。
為什麼 Gemini 3.1 Pro 輸入超過 200K token 時價格會變？+
目前費率分為兩個級距，未快取輸入超過 200,000 token 時適用較高級距。快取輸入依所選級距的快取輸入費率單獨計費。請查看各帳戶分組的即時價格表。
Gemini 3.1 Pro 可以生成圖片嗎？+
Gemini 3.1 Pro 接受支援的媒體，但回傳文字。需要生成圖片時，請使用圖片模型。
Gemini 3.1 Pro 函式呼叫需要 Customtools 嗎？+
一般版 Gemini 3.1 Pro 已支援函式呼叫。Customtools 改變的是工具選擇行為；宣告函式不需要使用它。