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 共用的官方价格表。
