Gemini 3.1 Pro Preview 與 Customtools：該選哪一個？
比較 Gemini 3.1 Pro 的兩種官方模型 ID，了解 Customtools 改變了什麼，以及何時適合在應用程式使用一般 Preview 模型。
以 Markdown 閱讀Gemini 3.1 Pro 的兩種名稱都是 Google 官方模型 ID。 gemini-3.1-pro-preview 是一般版模型。gemini-3.1-pro-preview-customtools 是一種變體，設計目的是讓代理在同時能使用 bash 時，更善用自訂工具。這個後綴並不代表「更多思考」，一般版模型本來就支援函式呼叫。[1]
一般程式開發、文件分析與多模態問題，可以先從一般 Preview 開始。若代理反覆選擇 shell 指令，而非你預期它使用的自訂函式，再考慮比較 Customtools。這項建議依據文件記載的差異；本文並未回報新的 A/B 基準測試。
兩種 Gemini 3.1 Pro 模型 ID
請將完整識別碼複製到設定中。兩種 ID 都包含 preview；Customtools 是該發布系列中的另一個選項。
| 模型 ID | 文件記載的用途 | 實用的評估問題 |
|---|---|---|
gemini-3.1-pro-preview | 具備推理與函式呼叫功能的一般模型 | 是否能根據提供的上下文準確完成任務？ |
gemini-3.1-pro-preview-customtools | 同時可用 bash 時，更優先選擇自訂工具 | 是否選擇預期的自訂工具，並正確使用其結果？ |
Google 在模型頁面上並列這兩種名稱，也提醒 Customtools 版本在無法受益於該工具工作流程的查詢中，可能出現品質差異。因此，不同後綴代表應針對特定行為進行評估，並非全面升級的證據。[1]
共用模型規格列出 1,048,576 token 的輸入上限、65,536 token 的輸出上限，以及多模態輸入與文字輸出。這些主要上限無法告訴你代理在特定對話中會選擇哪個工具。比較結果時，請分別看待模型識別碼、工具定義與任務成果。
Customtools 改變了什麼
Google 說明，當 bash 也可使用時，這個變體會偏好 view_file 和 search_code 等自訂函式。如果應用程式已定義用途明確、輸出與權限可預期的工具，這項差異就有意義。[1]
假設一個程式開發助理有三種選擇：讀取單一檔案的函式、搜尋程式碼庫符號的函式，以及通用 shell 工具。任務是找出某個函式的定義。程式碼庫搜尋函式與 shell 指令都可能有幫助。值得評估的是，模型是否選擇最符合應用程式預期工作流程的工具。
這是示意情境，並非任一模型的實際回應紀錄。Customtools 不保證特定呼叫、不會免除宣告函式的需求，也不會接管應用程式的權限檢查。是否執行呼叫，以及回傳什麼結果，仍由應用程式決定。
觀察到工具選擇問題後，這項差異才最具參考價值。如果一般版模型已經會選擇預期函式並完成任務，在尚未確定要衡量哪項改善前就更換變體，只會增加另一個變因。
Customtools 不是思考層級
Gemini 3.1 Pro 另有 low、medium 與 high 思考層級。原生 generateContent 預設為 high；此模型不支援 minimal。這些是生成設定，並非其他模型 ID。[2]
從 low 改為 high，可能改變任務使用的推理預算。將模型 ID 改為 Customtools，則是針對工具選擇行為。如果同時更動兩者，就無法從不同的答案判斷哪項變更產生了影響。
要進行有參考價值的比較，請固定提示詞、工具宣告、對話歷史紀錄、思考層級與輸出上限。Google 也建議 Gemini 3 的 temperature 保持在 1.0。比較要求的工作是否完成、呼叫了哪些工具、引數是否有效，以及回應回報多少用量。這些是評估建議，並非任一變體的實測優勢。
一般 Preview 也能使用函式
官方一般版模型規格列出支援函式呼叫。宣告函式、接收函式呼叫、在應用程式中執行，再傳回結果，都不需要 Customtools 後綴。[1]
以原生 tools[].functionDeclarations 定義函式介面。繼續對話時，請保留回傳的內容部分與思考簽章。如果失敗是因為缺少簽章、引數 schema 無效，或工具回應組合錯誤，那是協定問題；更換模型名稱不能證明問題已修復。
Gemini 3.1 Pro API 參考文件列出原生欄位與限制。加入整套工具前，先從小型函式與可核對的結果開始。
依照實際工作流程選擇
工作主要是文字生成、程式碼解釋、文件擷取或多模態分析時，先選一般 Preview。它也適合作為工具型應用程式的起點。評估前，先定義什麼樣的結果才算成功。
當應用程式結合 bash 與自訂工具，而且有可重現的具體選擇問題時，再比較 Customtools。準備一小組具有代表性的案例：一個適合使用專用函式、一個確實需要 shell，以及一個不應呼叫任何工具。請同時審查所選動作與最終結果。
不要只看變體呼叫偏好工具的頻率。沒有必要的函式呼叫，仍然沒有必要。實用的模型必須選擇適當動作、提供有效引數、解讀結果，並回答原始請求。
Google 定價頁將兩種 ID 列在同一份模型價格表中。這不代表思考設定、處理層級選項或 token 用量可以混為一談。比較請求時，請確認目前適用費率並檢視實際用量。[3]
SeedRouter 串接哪個版本？
Gemini 3.1 Pro 頁面使用 gemini-3.1-pro-preview。此串接尚未接入 Customtools 變體。頁面提供一般版模型的 Playground 與分組即時價格；API 參考文件則記錄目前的驗證範圍。
美元／100 萬 token
| 項目 | googlellm · ≤ 200,000 未快取輸入 token | googlellm · > 200,000 未快取輸入 token | googlellm-vertext · ≤ 200,000 未快取輸入 token | googlellm-vertext · > 200,000 未快取輸入 token |
|---|---|---|---|---|
| 輸入 | US$0.80 | US$1.60 | US$1.00 | US$2.00 |
| 輸出（含思考） | US$4.80 | US$7.20 | US$6.00 | US$9.00 |
| 快取輸入 | US$0.08 | US$0.16 | US$0.10 | US$0.20 |
標準處理費率。200,000 token 的門檻以未快取輸入計算。快取 token 單獨計費，不會再以未快取輸入重複計費。工具費用與快取儲存費用不包含在這些 token 範例中。
請在應用程式中使用精確的一般版模型 ID。為了控制評估條件，請明確設定處理選項，並先以自己的任務核對結果，再判斷設定是否適合正式環境。
常見問題
Gemini 3.1 Pro 的兩種模型名稱都是官方名稱嗎？
是。Google 在同一個模型頁面中記載 gemini-3.1-pro-preview 與 gemini-3.1-pro-preview-customtools。後者是專用變體，並非非官方拼法。
Customtools 會取代一般函式呼叫嗎？
不會。一般 Preview 已提供正常的函式呼叫。Customtools 改變模型在混合自訂工具與 bash 工作流程中的偏好；函式仍由應用程式宣告與執行。
Customtools 一定更適合程式開發嗎？
Google 並未提出這種全面性的主張。文件記載的差異涉及工具選擇，模型頁面也提醒，在預期工作流程之外可能出現品質差異。請比較程式開發應用程式真正需要的行為。
資料來源
於 2026 年 10 月 17 日核對。以上比較依據文件，並非新執行的品質基準測試。
- Google：Gemini 3.1 Pro 模型規格 — 官方 ID、輸入／輸出上限、函式呼叫與 Customtools 差異。
- Google：原生 Gemini 3 開發者指南 — 思考層級、原生請求設定與 temperature 建議。
- Google：Gemini API 定價 — 兩種模型 ID 共用的官方價格表。
