HappyHorse 1.0 即将上线了解更多
EvoLink.AIEvoLink.AI

Gemini 3.1 Pro CustomTools API

通过 EvoLink 兼容 OpenAI 的 /v1/chat/completions 端点使用请求模型 ID gemini-3.1-pro-customtools。在 EvoLink 上，它是 Gemini 3.1 Pro 家族里单独暴露出来的一条工具型路由。
模型类型:
✓Gemini 3.1 Pro CustomTools
价格: 

$1.600 - 3.200(~ 115.2 - 230.4 credits) per 1M input tokens; $9.600 - 14.400(~ 691.2 - 1036.8 credits) per 1M output tokens

$0.161 - 0.322(~ 11.6 - 23.2 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

Gemini 3.1 Pro CustomTools API 的最佳使用场景

以工具为中心的请求流

当你的工作负载围绕 tools 数组、结构化输出，以及模型与外部系统之间的多轮往返展开时，这条路由更容易被放进智能体链路、工具驱动抽取和编排型 API 工作流里。

高级函数调用

AI 智能体与自动化工作流

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

AI 智能体工作流

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

第 1 步 - 设置模型

在请求正文中使用 model: "gemini-3.1-pro-customtools"。您现有的工具/函数定义无需更改即可使用。

2

第 2 步 - 定义工具并发送消息

包含带函数定义的 tools 数组和带角色/内容对的 messages 数组。这条路由适合那种把工具选择、结构化输出和多轮工具使用都放进主请求流程里的工作负载。

3

第 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 3.1 Pro CustomTools 是 Gemini 3.1 Pro 家族里单独暴露出来的一条请求路由和模型 ID，面向工具密集型工作流。它不只是基础版 Gemini 3.1 Pro 页面上的另一种叫法。
在 EvoLink 上，更实际的区别是路由选择和工作负载定位。一般通用多模态推理继续使用 Gemini 3.1 Pro；当你希望把工具流量、结构化输出任务和智能体编排流量单独拆到一条请求路由上时，再使用 gemini-3.1-pro-customtools。
在 EvoLink 的 Gemini 3.1 Pro CustomTools API 中，请将模型值设为 "gemini-3.1-pro-customtools"。这是兼容 OpenAI 聊天补全端点的推荐模型字符串。
向 `api.evolink.ai/v1/chat/completions` 发送 POST 请求。使用来自 EvoLink 控制台的 API 密钥，并在请求头中包含 `Authorization: Bearer <token>` 和 `Content-Type: application/json`。
可以。CustomTools 完全兼容 OpenAI 的 tools 数组格式。您现有的函数定义、参数 Schema 和 tool_choice 设置无需修改即可使用。
输入 Token 限制为 1,048,576 (1M 上下文)，最大输出 Token 为 65,536。输入定价有阶梯费率：200K Token 以内为标准价格，超过 200K Token 为长上下文使用的较高费率。
支持。这条路由适合那种模型需要读取工具定义、选择工具、接收工具结果，并在同一个请求循环里持续推进多轮工具调用的工作流。

继续浏览 Gemini 系列页面和集成指南

Gemini 3.1 Pro CustomTools 在 Gemini 系列中的定位

可以把 CustomTools 看成 EvoLink 上 Gemini 3.1 Pro 家族里单独拆出来的一条工具型请求路由。当工作负载以函数调用、结构化输出和智能体编排为主时使用它；更广义的通用推理流量则继续留给基础版 Gemini 3.1 Pro。

将系列模型链接和集成内容集中在一处，让页面保持聚焦，下一步更清晰。