Gemini 3.1 Pro CustomTools API
$1.865 - 3.729(~ 126.8 - 253.6 credits) per 1M input tokens; $11.182 - 16.774(~ 760.4 - 1140.6 credits) per 1M output tokens
$0.187 - 0.374(~ 12.7 - 25.4 credits) per 1M cache read tokens
Google Search grounding charged separately per query.
稳定性最高,保证 99.9% 可用性。推荐用于生产环境。
所有版本使用同一个 API 端点,仅 model 参数不同。
Gemini 3.1 Pro CustomTools API
Gemini 3.1 Pro CustomTools 是 EvoLink 上单独暴露出来的请求路由和模型 ID,面向更偏工具调用的 Gemini 3.1 Pro 工作流。当你的请求依赖 tools 数组、结构化输出和多步智能体循环时用它;更广义的通用推理则继续放在基础版 Gemini 3.1 Pro 路由。
模型路由
Gemini 3.1 Pro CustomTools API
请求模型 ID
gemini-3.1-pro-preview-customtools

Gemini 3.1 Pro CustomTools API 的最佳使用场景
以工具为中心的请求流
当你的工作负载围绕 tools 数组、结构化输出,以及模型与外部系统之间的多轮往返展开时,这条路由更容易被放进智能体链路、工具驱动抽取和编排型 API 工作流里。

AI 智能体与自动化工作流
通过统一网关构建会调用外部 API、数据库或内部服务的智能体工作流。在 EvoLink 上,这个模型 ID 让你能在 Gemini 3.1 Pro 家族里单独拆出一条更偏工具流量的路由,而不是把这类请求混在基础版 Pro 路由里。

1M 上下文 + 结构化输出
把 1M 上下文窗口用于更长的智能体会话、更大的工具载荷和结构化抽取任务。这条路由把价格和模型 ID 与基础版 Pro 页面区分开来,更方便做路由规划。

为什么在 EvoLink 上使用 Gemini 3.1 Pro CustomTools
EvoLink 把 Gemini 3.1 Pro CustomTools 作为单独的请求路由和模型 ID 暴露出来,让团队在一个网关和一套鉴权方式下,也能把工具型 Gemini 流量和基础版 Gemini 3.1 Pro 路由拆开管理。
让智能体路由继续保持单网关
你可以把 gemini-3.1-pro-customtools 加进现有的 OpenAI 风格调用栈,而不用为了某一条工作流再维护一套 Google 专属接入路径。
把通用推理流量和工具流量拆开管理
使用单独的模型 ID,更容易把智能体流量、结构化输出任务和一般 Gemini 3.1 Pro 使用拆成不同路由,后续做成本和行为控制也更清晰。
生产级 Token 统计
用量统计包含 prompt_tokens、completion_tokens、total_tokens,以及 completion_tokens_details.reasoning_tokens,可单独跟踪工具规划开销。
如何调用 Gemini 3.1 Pro CustomTools
使用 OpenAI SDK 格式,配合现有的工具定义和 gemini-3.1-pro-customtools 模型字符串。
第 1 步 - 设置模型
在请求正文中使用 model: "gemini-3.1-pro-customtools"。您现有的工具/函数定义无需更改即可使用。
第 2 步 - 定义工具并发送消息
包含带函数定义的 tools 数组和带角色/内容对的 messages 数组。这条路由适合那种把工具选择、结构化输出和多轮工具使用都放进主请求流程里的工作负载。
第 3 步 - 处理工具调用和结果
处理响应中的 tool_calls,执行函数,再把结果发送回去。上线前先用本页的实时价格表确认这条路由的成本,再决定是否放进正式生产链路。
Gemini 3.1 Pro CustomTools API 功能与限制
针对工具密集型工作负载优化的核心能力
增强型函数调用
适合默认请求形态就包含函数调用、tools 数组和结构化输出的路由。
多步编排
处理链式工具调用,其中输出作为后续调用的输入,并保持上下文。
结构化输出
可靠的 JSON Schema 一致性,用于结构化数据提取和 API 响应格式化。
1M 上下文窗口
1,048,576 输入 Token,超过 200K 有阶梯定价,适用于长时间智能体会话和大型工具上下文。
推理 Token
completion_tokens_details 包含 reasoning_tokens,可单独跟踪工具规划开销。
兼容 OpenAI SDK
使用标准的 /v1/chat/completions 接口配合 tools 数组,无需自定义集成。
Gemini 3.1 Pro CustomTools API 常见问题
Everything you need to know about the product and billing.
EvoLink 上的 Gemini API 模型
CustomTools 是专为工具密集型工作流设计的 Gemini 3.1 Pro 路由。通用推理请用 Gemini 3.1 Pro 基础路由,速度优先用 Flash,预算批量任务用 Flash Lite。