把正式流量切到 gemini-3.1-pro-preview-customtools 之前该评估什么

在将生产流量切换到 gemini-3.1-pro-preview-customtools 之前，请先在具有代表性的流量样本上运行试点，并检查输出质量、峰值并发时的延迟以及每次请求的成本。验证错误和重试行为，并确认您所依赖的请求限制与您的计划相符。

Gemini 3.1 Pro Preview Custom Tools 的提示缓存功能可以节省多少空间？

对 Gemini 3.1 Pro Preview Custom Tools 进行提示缓存时，缓存的输入按每个 1,000,000 个 Token$0.20 计费，而不是标准输入每个 1,000,000 个 Token$2.00 计费。此节省仅适用于缓存的前缀；请求的其余部分按正常方式计费。

Gemini 3.1 Pro Preview Custom Tools 的 rate limit 是多少？

当前模型记录未公布 Gemini 3.1 Pro Preview Custom Tools 的数值 rate limit。请在控制台中确认您的套餐配额，然后在预期并发数下运行一次短期负载测试，以确定实际上限后再进行生产。

gemini-3.1-pro-preview-customtools 的输出预算该怎么设

将 gemini-3.1-pro-preview-customtools 的 max_tokens 设置为任务实际需要的最长响应长度，而不是 65,536 的 Token 上限。严格控制上限可以降低最坏情况下的开销并缩短尾延迟。仅当任务明显需要更长的输出时才提高此值。

Gemini 3.1 Pro Preview Custom Tools 对长时间输入收费更高吗？

是的。Gemini 3.1 Pro Preview Custom Tools 应用了高于 200,000 输入 Token 的更高长 context 层级。低于或等于该边界的请求使用标准速率。在计算成本之前，请测量您的请求长度并记录大部分流量属于哪个层级。

模型详情

Gemini 3.1 Pro Preview Custom Tools

由 Google 提供

按量付费动态计价 2 个档位

Gemini 3.1 Pro Preview 自定义工具是 Gemini 3.1 Pro 的一个变体，它通过防止在有更高效的第三方或用户定义函数可用时过度使用通用 bash 工具来改进工具选择行为。这个专门的预览端点显著提高了函数调用的可靠性，并确保模型在编码代理和复杂的多工具工作流程中选择最合适的工具。它保留了 Gemini 3.1 Pro 的核心优势，包括跨文本、图像、视频、音频和代码的多模态推理、1M token context window 以及强大的软件工程性能。

模型规格

模型 ID: gemini-3.1-pro-preview-customtools

上下文长度: 1.048576M
最大输出: 65.536K
输入/输出模态
发布日期: 2026-02

API 端点

单一 MixRoute 网关，OpenAI 兼容

Gemini /v1beta/models/{model}:generateContent POST
OpenAI-compatible /v1/chat/completions POST

阶梯价格

单位：/1M Tokens

档位	输入 /1M Tokens	输出 /1M Tokens	缓存读取 /1M Tokens
standard Length ≤ 200K	$2.0000	$12.0000	$0.2000
long_context Length > 200K	$4.0000	$18.0000	$0.4000

选型摘要

快速判断是否适合你的工作负载

这个模型适合什么？

多模态模型；输入：文本、图像、文件、语音、视频；输出：文本

Gemini 3.1 Pro Preview Custom Tools 是多模态模型。规格上，context window 为 1,048,576 个 Token，单次最多输出 65,536 个 Token。

使用前应检查什么？

1,048,576 context，输出上限 65,536

采用 Gemini 3.1 Pro Preview Custom Tools 前，输入超过 200,000 个 Token 会切换到较高费率；标准输入费率为 $2.00／100 万 Token；已声明支持工具调用、结构化输出、流式输出、提示词缓存、视觉输入、OpenAI SDK 兼容；知识库截止时间为 2025-01；发布于 2026-02-19。建议先以具有代表性的流量试跑，确认质量与延迟。

为什么通过 MixRoute 使用？

通过兼容端点以模型 ID 调用

输入不超过 200,000 个 Token 时，重复的前缀按每 100 万 Token $0.2000 的缓存读取价计费，标准输入为 $2.0000／100 万 Token；超过后分别为 $0.4000 与 $4.0000／100 万 Token，系统提示词的重复成本因此降低。MixRoute 以 OpenAI 兼容端点 /v1/chat/completions 提供 gemini-3.1-pro-preview-customtools；既有客户端只需指向 https://api.mixroute.ai/v1 并把模型 ID 换成 gemini-3.1-pro-preview-customtools，再跑一次集成测试即可。

能力与兼容性

未确认的能力保持“Unknown”，不做猜测

工具调用

gemini-3.1-pro-preview-customtools 支持函数调用与工具调用。

示例发送 tools 定义；响应会返回 tool_calls，执行后再把结果送回模型。

结构化输出

gemini-3.1-pro-preview-customtools 可以按需生成 JSON 格式的输出。

示例 response_format: { type: "json_schema" } 可强制输出有效的 JSON。

流式输出

gemini-3.1-pro-preview-customtools 支持流式响应。

示例 stream: true 会逐步流式返回 Token，聊天界面可以边接收边渲染。

提示缓存

gemini-3.1-pro-preview-customtools 在支持的路由条件下可以使用提示缓存。

示例将系统提示词与工具定义放在请求开头；重复的前缀会自动按缓存读取价格计费。

视觉输入

gemini-3.1-pro-preview-customtools 可以同时处理图像与文本输入。

示例在 image_url 内容块中传入 base64 编码的图片，与文本消息一起发送。

OpenAI SDK

通过 MixRoute 的 OpenAI 兼容端点调用 gemini-3.1-pro-preview-customtools。

示例将 base_url 改为 https://api.mixroute.ai/v1；其余部分遵循 OpenAI 风格。

Token 成本估算

基于本页价格的实时估算，非实际账单

输入 Token 每次请求上限 1.048576M

输出 Token 每次请求上限 65.536K

请求数 / 月

缓存命中率 0%

同一前缀被重复读取的输入占比，最高 100%

FAQ

对 Gemini 3.1 Pro Preview Custom Tools 的缓存命中要求所有请求的提示符前缀必须相同。请将稳定的指令和参考资料放在提示符的开头，保持字节一致，并将可变部分放在后面。这样，缓存读取将按缓存速率计费，而不是按输入速率计费。

快速开始

01

创建 API 密钥

在 Console 生成密钥；一个密钥即可调用所有模型。
02

设置 Base URL

完全兼容 OpenAI SDK；只需替换 URL 即可接入。

https://api.mixroute.ai/v1
03

指定模型 ID

在请求的 model 字段中输入：

gemini-3.1-pro-preview-customtools

创建 API 密钥

新用户可获得 $5 免费额度

本页内容

单一端点，可验证的决策

使用相同的请求格式测试此模型和备用路由

从真实工作负载开始，再由质量、总成本和故障条件决定是否接入生产流量。

创建 API 密钥查看集成文档