Google: Gemini 3.1 Pro Preview

以推理为先的 Gemini 预览版，面向智能体编程与复杂问题求解

gemini-3.1-pro-preview

可用Google聊天缓存输入便宜 90%

输入 / 输出-50%: $2.00 / $12.00$1.00 / $6.00
上下文: 1M
最大输出: 64K
模态: 视觉聊天
能力: 工具调用提示词缓存推理

Gemini 3.1 Pro Preview 简介

Gemini 3.1 Pro 是 Google Gemini 3.1 系列里以推理为先的 Pro 模型，目前是预览版。Google 称它具备高级智能、复杂问题求解能力和较强的智能体能力。它能读文本和图片，先思考再回答，调用工具，返回受 schema 约束的 JSON，并支持缓存。Flash 模型在困难任务上的答案不够好时，就该选它。

擅长的任务

内置思考能力，适合多步问题、调试和规划，这类任务第一次答错代价很高。
智能体编码是它明确的重点，工具调用可用于编辑和测试的循环。
图片和文本可放在同一个提示词里，用于分析示意图、图表和界面。
受 schema 约束的 JSON 输出和缓存，可支撑生产流水线。

什么情况换别的模型

它是预览版，Google 可能改变行为，或者在稳定版 Pro 发布后将它下线。
简单、高并发的调用，Flash 和 Flash-Lite 模型回答更快，也更合适。

快速上手

创建 API 密钥
在 Console 生成一把密钥，平台上的模型都能用。

发送第一个请求

复制你所用语言的示例代码，向该端点发起请求。

文本生成Gemini API

POST/v1beta/models/gemini-3.1-pro-preview:generateContent

API 格式:

curl "https://api.tokenlab.sh/v1beta/models/gemini-3.1-pro-preview:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: sk-xxx" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "Hello!"}]}
    ]
  }'

价格

Verified 价格用于 Verified，多数模型更便宜；Official 价格是模型厂商公布的价格，用于更稳定的 Official。Auto 按最终完成请求的线路计价。

输入 token <= 200K · 输入 token 范围 · <=200k

每 1M token

Official 价格: 输入 $2.00 / 输出 $12.00 / 缓存读取 $0.20
Verified 价格: 输入 $1.00 / 输出 $6.00 / 缓存读取 $0.10
折扣: -50%

输入 token > 200K · 输入 token 范围 · >200k

每 1M token

Official 价格: 输入 $4.00 / 输出 $18.00 / 缓存读取 $0.40
Verified 价格: 输入 $2.00 / 输出 $9.00 / 缓存读取 $0.20
折扣: -50%

提示词缓存价格

缓存读取

Official 价格: $0.20
Verified 价格: $0.10
折扣: -50%

工具附加费

按次计费，仅在模型实际使用工具时收取。

网页搜索

Official 价格: $0.014/次搜索
Verified 价格: $0.007/次搜索
折扣: -50%

	Official 价格每 1M token	Verified 价格每 1M token	折扣
输入 token <= 200K · 输入 token 范围 · <=200k	输入 $2.00 / 输出 $12.00 / 缓存读取 $0.20	输入 $1.00 / 输出 $6.00 / 缓存读取 $0.10	-50%
输入 token > 200K · 输入 token 范围 · >200k	输入 $4.00 / 输出 $18.00 / 缓存读取 $0.40	输入 $2.00 / 输出 $9.00 / 缓存读取 $0.20	-50%
提示词缓存价格
缓存读取	$0.20	$0.10	-50%
工具附加费按次计费，仅在模型实际使用工具时收取。
网页搜索	$0.014/次搜索	$0.007/次搜索	-50%

用量与动态

成功率是请求完成的比例；延迟是拿到一次完整响应要花的时间，P95 表示 95% 的请求都在这个时间内完成。

用量与可用性

直接在 Console 里试

Gemini 3.1 Pro Preview 已在 Console 备好，提示词已填好，可以直接修改或发送。

帮我用 gemini-3.1-pro-preview 发一条简短消息，接口是 /v1beta/models/gemini-3.1-pro-preview:generateContent。返回回复，附上延迟和费用。

使用场景

适用场景

推理
视觉

疑难调试
给它一份失败的构建日志和相关文件，让它找出根因并给出最小修复。
研究综合
把多份长文档综合成有推理依据的对比，并列出未决问题。
智能体规划
让它当规划者，拆分任务，把各步骤交给更便宜的模型。
视觉分析
读一张仪表盘截图或架构图，解释它说明了什么。

提示词示例

这个堆栈跟踪只在高负载下出现。附上了涉及的两个模块，找出最可能的竞态条件并给出修复方案。

从风险、成本结构和供应商锁定三个角度比较这三份供应商方案，并给出推荐及理由。

看这张架构图，列出所有单点故障。

此模型按条件计价，仅凭月度 token 总量无法可靠估算；请按请求规格、缓存和适用时段查看详细定价。

FAQ

Gemini 3.1 Pro 擅长什么？

复杂推理、智能体编码，以及跨文本和图片的分析。Google 称它是用于高级问题求解的模型。难题用重思考的设置，日常任务用更便宜的模型。

Gemini 3.1 Pro 是稳定版吗？

不是。Google 将它列为预览版，这意味着行为可能改变，模型也可能被替换。请保留一套评估集，以便发生这种情况时能发现变化。

它支持工具调用和返回 JSON 吗？

支持。函数调用和受 schema 约束的输出都支持，因此可以在自动化智能体流水线里担任规划者或审查者。

什么时候应该改选 3.8 Flash？

延迟比最后一点推理深度更重要时。3.8 Flash 是 Flash 档模型，Google 也将它用于长时间运行的软件任务；请在你最难的真实提示词上比较两者。

Gemini 3.1 Pro Preview 的费用是多少？

在 TokenLab 上，Gemini 3.1 Pro Preview 的价格为输入 $1.00 / 输出 $6.00 每 1M token。完整明细见上方价格表。价格因计费单位、规格和用量而异。请在模型的详细定价中对比相同条件下的费率；单一费率不代表总价。

Gemini 3.1 Pro Preview 的上下文窗口和输出上限是多少？

Gemini 3.1 Pro Preview 最多接收 1,048,576 token 的上下文，单次最多返回 65,536 token。

Gemini 3.1 Pro Preview 应该使用哪个端点？

Gemini 3.1 Pro Preview 使用 https://api.tokenlab.sh/v1beta/models/gemini-3.1-pro-preview:generateContent。代码写法见下方的请求示例。

Gemini 3.1 Pro Preview 支持哪些操作？

Gemini 3.1 Pro Preview 支持文本生成。选了操作，上面会显示对应的端点和请求示例。

Gemini 3.1 Pro Preview 对比

Gemini 3.1 Pro Preview 对比 Gemini 3.8 Flash Gemini 3.1 Pro Preview 对比 Claude Sonnet 4.6 Gemini 3.1 Pro Preview 对比 GPT-5.5 Gemini 3.1 Pro Preview 对比 Gemini 3 Flash Preview

资料来源

Gemini models overview

审阅于 2026年10月2日