Gemini 3.1 Pro

Gemini 3.1 Pro 是我们推理能力最强的 Gemini 模型，能够解决复杂问题。Gemini 3.1 Pro 能够利用其 100 万 token 的上下文窗口，理解来自不同信息来源（包括文本、音频、图片、视频、PDF 甚至整个代码库）的海量数据集和复杂难题。

如需详细了解如何使用最新的 Gemini 模型，请参阅 Gemini 3 使用入门。

质量方面的改进

Gemini 3.1 Pro 包含多项质量改进：

  • 改进了 SWE 和智能体功能：改进了软件工程行为和易用性，并在金融和电子表格应用等领域改进了智能体功能。
  • 提升了 token 效率和思考能力：在各种应用场景中思考效率更高。
  • 扩展的思考级别：引入 MEDIUM 作为 thinking_level 参数，提供更多选项，以便在成本、性能和速度之间实现最佳平衡。

自定义工具端点

对于结合使用 Bash 和自定义工具进行构建的用户，Gemini 3.1 Pro 支持一个额外的端点：gemini-3.1-pro-preview-customtools。此端点更擅长优先处理自定义工具（例如 view_file 或 search_code）。由于 gemini-3.1-pro-preview-customtools 针对使用自定义工具和 Bash 的 Agentic Workflows 进行了优化，因此在某些无法从这些工具中受益的使用场景中，您可能会看到质量波动。

gemini-3.1-pro-preview-customtools 的价格与 Gemini 3.1 Pro 相同。gemini-3.1-pro-preview-customtools 不支持预配吞吐量 (PT)，并且 gemini-3.1-pro-preview-customtools 上的多模态请求会强制执行旧版输入限制（每张图片最多 30 MiB，最多 10 个 HTTP 或 HTTPS 图片网址；每个 PDF 最多 50 MiB，最多 1,000 页；每个纯文本文件最多 7 MiB；每个请求最多 1 个 HTTP 或 HTTPS 音频或视频网址）。

在 Agent Studio 中试用 在 Model Garden 中查看 部署示例应用 价格

注意：“部署示例应用”需要一个启用了结算功能和 Agent Platform API 的 Google Cloud 项目。
模型 ID gemini-3.1-pro-preview
模态
文本 输入和输出
图片 仅输入
音频 仅输入
视频 仅输入
token 数量上限 上下文窗口 1,048,576
输出词元数上限 65536
功能
工具
API
使用选项
输入大小限制
  • GenerateContent API：500 MiB（压缩后）
  • Interactions API： 256 MiB（压缩后，同步或流式传输）；9.75 MiB（未压缩，延迟，当 background 和 store 为 true 时）
Interactions API URI 限制 在 Interactions API 上，每次请求中所有模态的 Cloud Storage (gs://) URI 总数不得超过 100 个，包括使用 previous_interaction_id 从先前轮次中继承的 URI。generateContent 支持的 gs:// URI 数量上限取决于每种模态的模型项限制（如果包含纯文本文件，则最多可包含 6,500 个多模态文件）。
技术规格 图片
  • 每个提示的图片数量上限：3,000（图片和 PDF 合计）
  • 内嵌部分的大小上限 (GenerateContent API)：256 MB
  • Cloud Storage 中每个文件的文件大小上限：2 GiB 减去 500 KiB
  • 来自公开 HTTP 或 HTTPS 网址的每个文件的文件大小上限：15 MiB
  • 在控制台中直接本地上传的每个文件的文件大小上限： 7 MiB 内嵌（最多 50 MiB 暂存到 Cloud Storage）
  • 在控制台中通过 Google 云端硬盘导入的每个文件的文件大小上限：7 MB（总共 10 MB）
  • 默认分辨率 token 数：1,120
  • 支持的 MIME 类型：
    image/png、image/jpeg、image/webp、image/heic、image/heif
文字
  • 每个提示的文件数量上限： 3,000 个 PDF 文件（与图片共享；如果包含纯文本，则总文件数上限为 6,500 个）
  • 每个文件的页数上限：3,000
  • 内嵌部分的大小上限 (GenerateContent API)：256 MB
  • Cloud Storage 中每个文件的文件大小上限：2 GiB 减去 500 KiB
  • 来自公开 HTTP 或 HTTPS 网址的每个文件的文件大小上限：15 MiB
  • 在控制台中直接本地上传的每个文件的文件大小上限： 7 MiB 内嵌（最多 50 MiB 暂存到 Cloud Storage）
  • 在控制台中通过 Google 云端硬盘导入的每个文件的文件大小上限：7 MB（总共 10 MB）
  • 默认分辨率 token 数：560
  • 适用于扫描版 PDF 的 OCR：默认不使用
  • 支持的 MIME 类型：
    application/pdf、text/plain
视频
  • 视频时长上限（包含音频）：约 45 分钟
  • 视频时长上限（不含音频）：约 1 小时
  • 每个提示的视频数量上限：10
  • 内嵌部分的大小上限 (GenerateContent API)：256 MB
  • Cloud Storage 中每个文件的文件大小上限：2 GiB 减去 500 KiB
  • 来自公开 HTTP 或 HTTPS 网址的每个文件的文件大小上限：15 MiB
  • 每帧的默认分辨率 token 数：70
  • 支持的 MIME 类型：
    video/x-flv、video/quicktime、video/mpeg、video/mpegs、video/mpg、video/mp4、video/webm、video/wmv、video/3gpp
音频
  • 每个提示的音频长度上限：约 8.4 小时或最多 100 万个 token
  • 每个提示的音频文件数量上限：1,000
  • 内嵌部分的大小上限 (GenerateContent API)：256 MB
  • Cloud Storage 中每个文件的文件大小上限：2 GiB 减去 500 KiB
  • 来自公开 HTTP 或 HTTPS 网址的每个文件的文件大小上限：15 MiB
  • 语音理解用途：音频总结、转写和翻译
  • 支持的 MIME 类型：
    audio/x-aac、audio/flac、audio/mp3、audio/m4a、audio/mpeg、audio/mpga、audio/mp4、audio/ogg、audio/pcm、audio/wav、audio/webm
参数默认值
  • 温度：0.0-2.0（默认值为 1.0）
  • topP：0.0-1.0（默认值为 0.95）
  • topK：64（固定值）
  • candidateCount：1-8（默认值为 1）
支持的区域

模型可用性

  • 全球：global
版本
  • gemini-3.1-pro-preview
    • 发布阶段：公开预览版
    • 发布日期：2026 年 2 月 19 日
  • gemini-3.1-pro-preview-customtools*
    • 发布阶段：公开预览版
    • 发布日期：2026 年 2 月 23 日
* 此端点不支持预配吞吐量 (PT)，并且适用旧版多模态文件大小、页数以及 HTTP 或 HTTPS 网址限制（请参阅自定义工具端点）。