Gemini 3.1 Pro 说明：发布时间、API 规格与预览状态
更新日期：2026年10月24日
Gemini 3.1 Pro 是 Google 于 2026 年 2 月 19 日公布的 Gemini 3 系列模型更新，官方将重点放在更强的推理能力、软件工程表现和多步骤工具工作流上。本文区分 Google 发布公告中的能力说明与 Gemini API 文档中的可核验规格；模型版本和服务状态可能继续变化，使用前应查看官方页面。
一、Gemini 3.1 Pro 是什么
Google 在发布公告中称，Gemini 3.1 Pro 面向“简单答案不够用”的复杂任务，并将其描述为对 Gemini 3 Pro 核心智能的升级。公告公布时，模型正在面向消费者和开发者产品逐步推出；API 与部分开发者工具中的版本标注为预览版。
公告还报告了模型在 ARC-AGI-2 上经验证的 77.1% 分数，并称其在该基准上的推理表现超过 Gemini 3 Pro 的两倍。这是 Google 公布的基准测试结果，不等同于所有任务上的普遍准确率，也不能代替对具体工作负载的评测。测试口径和其他基准请参阅 Google 发布公告及其引用的评测资料。
二、Gemini 3.1 Pro API 的已公开规格
截至本文更新日，Google 的 Gemini API 模型文档将此模型列为预览版本，API 模型代码为 gemini-3.1-pro-preview。文档列出的规格如下：
| 项目 | 官方文档所列信息 |
|---|---|
| 模型标识 | gemini-3.1-pro-preview |
| 输入 | 文本、图片、视频、音频和 PDF |
| 输出 | 文本 |
| 输入 token 上限 | 1,048,576 |
| 输出 token 上限 | 65,536 |
| 文档列出的功能 | 思考、函数调用、代码执行、结构化输出、Google 搜索接地、Google Maps 接地、网址上下文和上下文缓存 |
| 额外说明 | 文件搜索标为仅 AI Studio 支持；图片生成与 Live API 不受支持 |
这些是 API 模型页中的规格，不代表 Gemini App、NotebookLM、Vertex AI 或第三方服务提供完全相同的模型选择、额度、地区和功能。Google 也可能更新端点和支持范围，生产环境应在部署时重新核对模型页、价格页及弃用说明。
官方模型页还列出独立端点 gemini-3.1-pro-preview-customtools，面向同时使用 Bash 与自定义工具的开发代理。Google 提醒，这个端点针对相应工具工作流做了优化；对于无法利用这类工具的任务，输出质量可能波动。不要仅因端点名称相似就替换默认模型，应先用实际任务验证。
三、适用任务与评估方式
按官方定位，3.1 Pro 可作为复杂推理、软件工程和需要精确工具使用的任务候选模型。具体是否适用，应根据你自己的输入数据、工具链和失败代价判断，而不能只凭发布演示或单项基准得出结论。
上线前可用一组固定任务比较模型表现：
- 代码工作流记录从需求理解、修改到测试的端到端成功率，并检查是否引入回归。
- 研究与文档任务核对结论是否能回到原始资料，检查引用和数字是否准确。
- 工具调用任务统计工具选择、参数格式、重复调用和失败恢复情况。
- 多模态任务检查模型是否读对图片、视频或 PDF 中的关键字段；对于小字、图表刻度和时间戳，应单独抽样复核。
- 同时记录延迟、token 用量、错误率和成本，并与当前生产版本比较。
工具接入时，应用本身仍应校验参数和权限。读操作与写入、发送、删除等高影响动作应分别设置授权边界；函数调用只是模型提出的工具请求，不是安全验证机制。可参阅 Google 的函数调用文档和安全指南。
四、预览版意味着什么
API 模型页当前使用的模型 ID 带有 preview 后缀，Google 的模型版本说明也区分稳定版、预览版及实验版。预览状态可能伴随配额、价格、接口或可用性调整，因此不要把该 ID 视为长期不变的生产接口。
开发者应在配置中集中管理模型 ID，记录调用日期和所用版本，建立回归测试，并在迁移前阅读官方弃用公告。不要在应用中硬编码“最新”或“最强”等无法由固定版本保证的描述。Gemini API 可用区域、计费和账户权限以 Google 当前官方说明为准。
五、官方资料与相关页面
- Google：Gemini 3.1 Pro 发布公告（2026年2月19日）
- Google AI for Developers：Gemini 3.1 Pro API 模型页
- Gemini API：模型列表与版本说明
- Gemini API：价格
- Gemini API：弃用说明
- Gemini API：函数调用
- Gemini API：安全指南
如果你要了解上一代 Gemini 3 Pro 的发布背景和当前 API 状态，请阅读Gemini 3 Pro 发布回顾。
常见问题
Gemini 3.1 Pro 已经正式稳定了吗？
Gemini API 模型页目前将 gemini-3.1-pro-preview 标为预览版。其他 Google 产品的开放范围可能不同，应查看对应产品和账户中的实时说明。
Gemini 3.1 Pro API 支持多大的上下文？
Google API 模型页列出输入上限为 1,048,576 tokens、输出上限为 65,536 tokens。实际可用限制还受接口、请求内容和账户配额影响，集成前请复核官方文档。
Gemini 3.1 Pro 的评测分数能代表我的业务效果吗？
不能。公开基准适合提供有限的参考，不保证模型在你的数据和工作流中同样表现。应使用代表性样本进行回归测试，并人工复核高风险输出。