Gemini 3.1 Pro — 深入分析代码与文档
Gemini 3.1 Pro 将文本、图片、音频、视频和 PDF 汇集到同一段对话中。选择思考级别，请求结构化文本，并在应用调用工具时保留原始对话部分。 US$0.80 / 1M 输入 · US$4.80 / 1M 输出.
- 100 万 token 输入
- 65,536 token 输出
- 三种思考级别
- 函数调用
- 多模态输入
Playground
使用原生请求探索 Gemini 3.1 Pro。选择账户分组、检查设置，并使用余额提交请求。实际能力验证仍待完成。
gemini-3.1-pro-preview$0.80 输入 · $4.80 输出，每百万 token更多 Gemini 参数
Gemini 3.1 Pro 价格
下方 Gemini 3.1 Pro 价格读取自当前计费配置。比较账户可用分组的输入、输出和缓存输入费率。未缓存输入超过 200,000 token 的请求使用长上下文档位。
示例用量仅供说明。实际账单以每个请求报告的 token 数为准。 标准处理费率。200,000 token 的边界按未缓存输入计算。缓存 token 单独计费，不会再次按未缓存输入计费。工具费用和缓存存储费用不包含在这些 token 示例中。
| 类别 | googlellm · ≤ 200,000 未缓存输入 token价格 · 百万 token | googlellm · > 200,000 未缓存输入 token价格 · 百万 token | googlellm-vertext · ≤ 200,000 未缓存输入 token价格 · 百万 token | googlellm-vertext · > 200,000 未缓存输入 token价格 · 百万 token |
|---|---|---|---|---|
| 输入 | $0.80 | $1.60 | $1.00 | $2.00 |
| 输出（含思考） | $4.80 | $7.20 | $6.00 | $9.00 |
| 缓存输入 | $0.08 | $0.16 | $0.10 | $0.20 |
只有未缓存输入决定档位。缓存输入按该档位的费率单独计费。示例使用标准档位。
Gemini 3.1 Pro 是什么？
Gemini 3.1 Pro 是 Google 推出的推理模型，用于理解代码、比较文档和解释跨媒体信息。请一并提供材料、问题和预期的答案格式。
常规 Gemini 3.1 Pro 使用 gemini-3.1-pro-preview。Google 还提供专门调整工具选择行为的 customtools 变体文档。本页接入常规版本；思考深度是另一项独立设置。
官方模型上限核对日期：2026 年 10 月 17 日。输入与输出各有独立上限。
开始使用 Gemini 3.1 Pro
从一个有代表性的任务开始。保存输入和设置，方便比较。
试用 Playground
发送一条 Gemini 3.1 Pro 消息，附上支持材料，并在提交前检查原生 JSON 请求。官方控件采用原生字段名和类型；自定义 JSON 会原样发送，由 Gemini API 校验。
选择账户分组
从你的账户可用的 Gemini 3.1 Pro 分组中选择。Playground 会更新所选分组的费率；新增分组也会出现在同一个按账户权限生成的列表中。
使用 API 参考
将原生 Gemini 3.1 Pro 示例复制到应用中。参考文档列出了请求字段、响应字段、媒体输入，以及仍需实际验证的能力。
Gemini 3.1 Pro 能帮助你构建什么
先确定输出契约，再对照源材料检查结果。
分析代码改动
让 Gemini 3.1 Pro 跨相关函数追踪 bug，解释其假设，并提出范围明确的补丁。接受改动前，请先运行测试。
返回结构化数据
向 Gemini 3.1 Pro 提供用于提取或分类的 JSON 响应 schema。请对照文档核查返回值；JSON 格式有效本身不能证明事实准确。
配合你的函数工作
声明具名函数及其参数 schema。Gemini 3.1 Pro 可以返回函数调用，供应用执行；由你的代码决定允许哪些操作。
比较媒体与文本
将图表、截图或 PDF 与问题放在一起。Gemini 3.1 Pro 接受多模态输入并返回文本，适合根据所提供的材料作出解释。
Gemini 3.1 Pro 实用任务
以下是建议工作流，不声称任何基准测试成绩或客户成果。
审查代码库改动
向 Gemini 3.1 Pro 提供相关文件和测试失败信息。要求它给出解决失败问题的最小改动，并单独说明尚存的不确定性。
提取文档清单
让 Gemini 3.1 Pro 将提供的文档转为结构化清单。在 schema 中加入来源位置，方便审阅者核查每个提取项。
解释录制的演示
提供一个受支持格式的短视频，让 Gemini 3.1 Pro 描述特定步骤。将问题限定在可见证据范围内，并要求它指出不清楚的细节。
如何使用 Gemini 3.1 Pro
- 01
准备访问权限
登录、充值并创建服务器端 API key。在 Playground 中打开 Gemini 3.1 Pro，检查请求格式。
- 02
提供上下文
将提示词和先前对话放在 contents 中。为 Gemini 3.1 Pro 提供媒体输入时，请使用正确的 MIME 类型和受支持的文件引用。
- 03
选择思考与输出设置
使用 low、medium 或 high 思考级别。Gemini 3.1 Pro 默认为 high；对响应长度有要求时，请明确设置 maxOutputTokens。
- 04
检查响应
读取 candidates、finishReason 和 usageMetadata。发送下一轮对话时，请保留 Gemini 3.1 Pro 的思考签名和工具部分。
原生 Gemini 3.1 Pro API
Gemini 3.1 Pro 使用 generateContent 获取 JSON 响应，使用 streamGenerateContent 获取服务器发送事件。独立参考文档提供了可复制示例和完整参数 schema。
准确的模型名称
在 URL 中使用 gemini-3.1-pro-preview。Gemini 3.1 Pro 这样的显示名称不能替代 API 标识符。
明确生成设置
Gemini 3.1 Pro 保留了 temperature 和采样字段。Google 建议 temperature 为 1.0。思考级别、输出格式和工具仍是独立的控制项。
读取实际用量
Gemini 3.1 Pro 的输出用量包含思考 token。缓存输入计入用于判断上下文阈值的总输入，并按缓存输入费率计价。
两个官方 Gemini 3.1 Pro 变体
区别在于工具选择，并非另一种推理级别。本页仅接入常规 Gemini 3.1 Pro 模型。
| 选项 | 常规 Preview | Customtools Preview |
|---|---|---|
| API ID | gemini-3.1-pro-preview | gemini-3.1-pro-preview-customtools |
| 文档说明的用途 | 通用推理与工具使用 | 同时提供 bash 时优先使用自定义工具 |
| 函数调用 | 支持 | 专门调整的工具选择行为 |
| 评估问题 | 能否解决实际任务？ | 能否选择预期的自定义工具？ |
Google 提醒，Customtools 在其目标工作流以外的任务中可能出现质量波动。这是文档对比，并非新运行的 A/B 基准测试。 Google 模型文档
Gemini 3.1 Pro 限制
输入与输出预算独立
Gemini 3.1 Pro 最多接受 1,048,576 个输入 token，最多生成 65,536 个输出 token。思考会消耗输出预算；即使答案简短，也可能需要思考 token。
仅输出文本
Gemini 3.1 Pro 可以分析受支持的媒体，但不生成图片或音频。需要这些输出时，请使用专门的生成模型。
检查进阶能力
Gemini 3.1 Pro 的官方模型规格列明支持工具。此处对媒体、缓存和各项工具的实际检查仍待完成；参数被接受并不能证明相应行为已经生效。
缓存资源需要访问权限
cachedContent 的值指向现有缓存资源。名称格式正确并不意味着 Gemini 3.1 Pro 就能使用该缓存；仍需满足资源访问权限和模型兼容性要求。
通过 SeedRouter 使用 Gemini 3.1 Pro
共用一个账户余额
Gemini 3.1 Pro 与其他已列出的文本、图像和视频模型可使用同一份 SeedRouter 余额。请遵循各模型自身的请求格式与约束。
在模型旁查看价格
在本页检查 Gemini 3.1 Pro 的 token 费率，并选择打算使用的账户分组。价格表读取自当前计费配置。
成功请求按用量付费
失败的 Gemini 3.1 Pro 请求不收费。成功请求按报告的 token 用量计费，包括思考和缓存输入。
探索其他文本模型
比较可用文本模型的文档能力与当前费率。
用 OpenAI SDK 调用 GPT-6 Astra。OpenAI 能力最强的模型，105 万 token 上下文，按 token 实时计价，Playground 在线即可试用。
查看价格用 OpenAI SDK 调用 GPT-6 Sol：105 万 token 上下文，推理强度从 none 到 max 可调，按 token 实时计价，Playground 在线即可试用。
查看价格用 OpenAI SDK 调用 GPT-6.1 Sol：编码与代理能力接近 Astra，价格仅为其五分之一，105 万 token 上下文，缓存输入低至 5% 费率。立即试用。
查看价格用 OpenAI SDK 调用 GPT-6 Luna。GPT-6 系列价格最低的模型，105 万 token 上下文，按 token 实时计价，Playground 在线即可试用。
查看价格体验 Claude Haiku 5.5 的文本分类、文档信息提取与摘要功能。查看实时输入与输出 token 价格，测试自己的提示词，并通过 Messages API 将模型接入你的实际应用。
查看价格用 Claude Sonnet 5.5 审查代码、解答文档问题。查看实时 token 价格，在 Playground 中测试提示词并检查回答与用量，了解经过验证的能力和兼容性限制，再将模型接入应用。
查看价格Gemini 3.1 Pro 常见问题
Gemini 3.1 Pro 应该使用哪个模型 ID？+
此处 Gemini 3.1 Pro 使用 gemini-3.1-pro-preview。独立的 customtools 变体会在同时提供 bash 时优先使用自定义工具。
Gemini 3.1 Pro 默认使用什么思考级别？+
Gemini 3.1 Pro 默认为 high。支持 low 和 medium，不支持 minimal。不要同时使用 thinkingLevel 与 thinkingBudget。
为什么 Gemini 3.1 Pro 的价格在输入超过 200K token 后变化？+
当前费率分为两个档位，未缓存输入超过 200,000 token 时适用较高档位。缓存输入按所选档位的缓存输入费率单独计费。请查看各账户分组的实时价格表。
Gemini 3.1 Pro 能生成图片吗？+
Gemini 3.1 Pro 接受受支持的媒体，但返回文本。需要生成图片时，请使用图像模型。
Gemini 3.1 Pro 函数调用需要使用 Customtools 吗？+
常规 Gemini 3.1 Pro 支持函数调用。Customtools 改变的是工具选择行为；声明函数不需要使用该变体。