# Gemini 3.1 Pro 预览版

Gemini 3.1 Pro Preview 旨在完善 Gemini 3 Pro 系列的性能和可靠性，提供更好的思考、改进的 token 效率以及更扎实、与事实一致的体验。它针对软件工程行为和可用性以及需要精确工具使用和跨实际领域可靠的多步骤执行的智能体工作流程进行了优化。

{% button
   href="https://aistudio.google.com/prompts/new_chat?model=gemini-3.1-pro-preview"
   variant="ais" %}
在 Google AI Studio 中体验
{% /button %}

## 文档  {% #documentation %}

参观 [Gemini 3 开发者指南](/docs/latest-model) 页面全面覆盖特性和功能。

## gemini-3.1-pro-preview  {% #gemini-31-pro-preview %}

{% doc-table variant="model" %}
{% doc-row header="true" %}
{% doc-cell %}
属性
{% /doc-cell %}

{% doc-cell %}
说明
{% /doc-cell %}
{% /doc-row %}

{% doc-row header="false" %}
{% doc-cell %}
{% section class="model-property" %}
{% icon name="id_card" /%}模型代码
{% /section %}
{% /doc-cell %}

{% doc-cell %}
`gemini-3.1-pro-preview`
{% /doc-cell %}
{% /doc-row %}

{% doc-row header="false" %}
{% doc-cell %}
{% section class="model-property" %}
{% icon name="save" /%}支持的数据类型
{% /section %}
{% /doc-cell %}

{% doc-cell %}
**输入** 文本、图像、视频、音频和 PDF

**输出** 文本
{% /doc-cell %}
{% /doc-row %}

{% doc-row header="false" %}
{% doc-cell %}
{% section class="model-property" %}
{% icon name="token_auto" /%}token 限制{% sup %}[[*]](/docs/tokens){% /sup %}
{% /section %}
{% /doc-cell %}

{% doc-cell %}
**输入token限制** 1,048,576

**输出 token 限制** 65,536
{% /doc-cell %}
{% /doc-row %}

{% doc-row header="false" %}
{% doc-cell %}
{% section class="model-property" %}
{% icon name="handyman" /%}功能
{% /section %}
{% /doc-cell %}

{% doc-cell %}
{% section class="three-column-grid" %}
{% section %}
[**音频生成**](/docs/speech-generation)

{% badge type="not-supported" /%}
{% /section %}

{% section %}
[**代码执行**](/docs/code-execution)

{% badge type="supported" /%}
{% /section %}

{% section %}
[**上下文缓存**](/docs/caching)

{% badge type="supported" /%}
{% /section %}

{% section %}
[**文件搜索**](/docs/file-search)

{% badge type="supported" /%}
{% /section %}

{% section %}
[**函数调用**](/docs/function-calling)

{% badge type="supported" /%}
{% /section %}

{% section %}
[**使用 Google 地图提供事实依据**](/docs/maps-grounding)

{% badge type="supported" /%}
{% /section %}

{% section %}
[**使用 Google 搜索提供事实依据**](/docs/google-search)

{% badge type="supported" /%}
{% /section %}

{% section %}
[**图像生成**](/docs/image-generation)

{% badge type="not-supported" /%}
{% /section %}

{% section %}
[**Live API**](/docs/live-api)

{% badge type="not-supported" /%}
{% /section %}

{% section %}
[**结构化输出**](/docs/structured-output)

{% badge type="supported" /%}
{% /section %}

{% section %}
[**思考**](/docs/thinking)

{% badge type="supported" /%}
{% /section %}

{% section %}
[**URL 上下文**](/docs/url-context)

{% badge type="supported" /%}
{% /section %}
{% /section %}
{% /doc-cell %}
{% /doc-row %}

{% doc-row header="false" %}
{% doc-cell %}
{% section class="model-property" %}
{% icon name="speed" /%}消费选择
{% /section %}
{% /doc-cell %}

{% doc-cell %}
{% section class="three-column-grid" %}
{% section %}
[**Batch API**](/docs/batch-api)

{% badge type="supported" /%}
{% /section %}

{% section %}
[**弹性推理**](/docs/flex-inference)

{% badge type="supported" /%}
{% /section %}

{% section %}
[**优先推理**](/docs/priority-inference)

{% badge type="supported" /%}
{% /section %}
{% /section %}
{% /doc-cell %}
{% /doc-row %}

{% doc-row header="false" %}
{% doc-cell %}
{% section class="model-property" %}
{% icon name="123" /%}版本
{% /section %}
{% /doc-cell %}

{% doc-cell %}
阅读 [模型版本模式](/docs/models#model-versions) 了解更多详情。

* 预览： `gemini-3.1-pro-preview`
* 预览： [`gemini-3.1-pro-preview-customtools`](/docs/models/gemini-3.1-pro-preview#gemini-31-pro-preview-customtools)
{% /doc-cell %}
{% /doc-row %}

{% doc-row header="false" %}
{% doc-cell %}
{% section class="model-property" %}
{% icon name="calendar_month" /%}最新更新
{% /section %}
{% /doc-cell %}

{% doc-cell %}
二月 2026
{% /doc-cell %}
{% /doc-row %}

{% doc-row header="false" %}
{% doc-cell %}
{% section class="model-property" %}
{% icon name="id_card" /%}模型详情
{% /section %}
{% /doc-cell %}

{% doc-cell %}
[模型详情](https://deepmind.google/models/model-cards/gemini-3-1-pro/)
{% /doc-cell %}
{% /doc-row %}

{% doc-row header="false" %}
{% doc-cell %}
{% section class="model-property" %}
{% icon name="paid" /%}价格
{% /section %}
{% /doc-cell %}

{% doc-cell %}
[价格](/docs/pricing#gemini-3.1-pro-preview)
{% /doc-cell %}
{% /doc-row %}
{% /doc-table %}

#### gemini-3.1-pro-preview-customtools  {% #gemini-31-pro-preview-customtools %}

对于那些混合使用 bash 和自定义工具进行构建的人来说，Gemini 3.1 Pro Preview 附带了一个单独的端点，可通过 API 访问，称为 `gemini-3.1-pro-preview-customtools`。该端点更适合确定自定义工具的优先级（例如 `view_file` 或 `search_code`).

请注意，虽然 `gemini-3.1-pro-preview-customtools` 针对使用自定义工具和 bash 的智能体工作流程进行了优化，您可能会在某些无法从此类工具中受益的用例中看到质量波动。
