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 的代理工作流进行了优化，因此在某些不使用此类工具的使用场景中，您可能会看到质量波动。

gemini-3.1-pro-preview-customtools 的价格与 Gemini 3.1 Pro 相同。gemini-3.1-pro-preview-customtools 不支持预配吞吐量 (PT) 。

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

注意：“部署示例应用”需要启用结算功能和 Agent Platform API 的 Google Cloud 项目。
模型 ID gemini-3.1-pro-preview
模态
Text Input and output
Image Input only
Audio Input only
Video Input only
token 数量上限 上下文窗口 1,048,576
输出词元数上限 65536
功能
工具
使用选项
技术规范 图片
  • 每个提示的图片数量上限： 3,000
  • 内嵌数据或通过控制台直接上传的每个文件的文件大小上限： 7 MB
  • Google Cloud Storage 中每个文件的文件大小上限： 30 MB
  • 默认分辨率 token 数： 1,120
  • 支持的 MIME 类型：
    image/png、image/jpeg、image/webp、image/heic、image/heif
文本
  • 每个提示的文件数量上限： 3,000
  • 每个文件的页数上限： 3,000
  • 通过 API 或 Cloud Storage 导入时，每个文件的文件大小上限： 50 MB(application/pdf) 或 7 MB(text/plain)
  • 通过控制台直接上传的每个文件的文件大小上限： 7 MB
  • 默认分辨率 token 数： 560
  • 适用于扫描版 PDF 的 OCR： 默认不使用
  • 支持的 MIME 类型：
    application/pdf、text/plain
视频
  • 视频时长上限（包含音频）： 约 45 分钟
  • 视频时长上限（不含音频）： 约 1 小时
  • 每个提示的视频数量上限： 10
  • 每帧的默认分辨率 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
  • 语音理解用途： 音频总结、转写和翻译
  • 支持的 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)。