Google
•
Gemini 3.1 Pro Preview
•
Released 
February 2026

Google
Gemini 3.1 Pro Preview

Gemini 3.1 Pro endpoint tuned to pick your custom tools over bash in coding agents, with 1M-token context.

Modality:
Text
Image
Audio
Video
PDF
model ID
google/gemini-3.1-pro-preview-customtools

Output Speed *

122.67
tok/s

Intelligence Index *

29.7
/ 100

Context Window *

1048576
tokens

Input price

12
Anytoken

Output price

72
Anytoken
Gemini 3.1 Pro That Prefers Your Tools Over Bash Gemini 3.1 Pro Preview Custom Tools is a separate Google API endpoint, gemini-3.1-pro-preview-customtools, built on Gemini 3.1 Pro. Google positions it for builders mixing bash with custom tools, and says it better prioritizes tools such as view_file or search_code. It accepts text, image, video, audio and PDF input and outputs text. It suits coding agents and multi-tool pipelines. Google warns of quality fluctuations in use cases that don't benefit from such tools. Access Gemini 3.1 Pro Custom Tools via API

Performance

The Change Is Tool Selection; the Reasoning Base Is Gemini 3.1 Pro

This endpoint exists to correct one behavior: Google says it is better at prioritizing custom tools such as view_file or search_code when bash is also available. We found no Google-published or independent benchmark that isolates customtools, so the gain is documented behavior, not a measured score. In practice, agents that register many functions should route here and verify tool-call accuracy on their own traces. For tool-free chat or writing, expect possible quality drift.

Benchmarks

Independent Data Covers the Standard Endpoint: Strong Throughput, Slow First Token

Artificial Analysis benchmarked gemini-3.1-pro-preview, not customtools, and we found no separate customtools measurements. <cite index="11-4">There it scores 30 on the Intelligence Index, above the comparable-model median of 26.</cite> <cite index="11-1">Output speed is 116.4 tokens per second.</cite> <cite index="11-9">Time to first token is 22.54 seconds, against a 3.76-second median for similar reasoning models.</cite> Fast generation follows a long thinking pause, so lower the thinking level for interactive use.

Output Speed

*
122.67
tok/s

Intelligence Index

*
29.7
/ 100

MMLU *

Broad world knowledge and problem-solving
0
%

GPQA *

PhD-level scientific reasoning across physics, biology, chemistry.
94
%

HLE *

Adherence to multi-step structured instructions.
47
%

LiveCodeBench *

Tool-calling reliability in long agentic loops.
0
%

Technical Specifications

What the model supports

The endpoint accepts text, audio, images, video and PDFs, returns text only, and has a 1,048,576-token context window with a 65,536-token maximum output. The output cap, not the window, limits full-corpus rewrites. Thinking level high is the default and may delay the first output token significantly, so set the level per request. Provisioned Throughput is not supported on this endpoint in Vertex AI.
Verified Specifications — 
Gemini 3.1 Pro Preview
*
Input modalities
Text
Image
Audio
Video
PDF
output modalities
Text
Context window
1048576
 tokens
Maximum output tokens
65536
Reasoning
Yes
Knowledge cutoff
February 2026
Pricing (standard)
12
 AnyTokens in
 / 
72
 AnyTokens out

Comparison

Gemini 3.1 Pro Preview Custom Tools or Standard Gemini 3.1 Pro Preview for Agents?

These are two endpoints of the same Gemini 3.1 Pro preview. <cite index="1-3">Both are documented with a 1,048,576-token input limit and a 65,536-token output limit.</cite> <cite index="9-4">Vertex AI states that customtools pricing is identical to Gemini 3.1 Pro.</cite> The decision is about behavior: the standard endpoint is the general default, while customtools <cite index="9-2">better prioritizes custom tools</cite> in agents that also have bash. The question is whether your workload benefits from that bias.

Dimension
Gemini 3.1 Pro Preview
Gemini 3.1 Pro Preview
Context window *
1048576
tokens
1048576
tokens
Output speed *
122.67
tok/s
122.67
tok/s
Intelligence Index *
29.7
29.7
Input pricing
12
AnyToken
12
AnyToken
Output pricing
72
AnyToken
72
AnyToken
Knowledge cutoff *
February 2026
February 2026

Choose Gemini 3.1 Pro Preview Custom Tools when your agent exposes functions like view_file or search_code next to bash and the model keeps defaulting to shell commands. Choose standard Gemini 3.1 Pro Preview for general chat, analysis, writing, or coding without registered tools, where <cite index="1-6">Google warns customtools may show quality fluctuations.</cite> Run both on your own agent traces before committing, since no customtools-specific benchmark is published.

Limitations & Trade-offs

Where Gemini 3.1 Pro Preview falls short

1
Quality drift without tools. <cite index="1-6">Google notes that customtools is optimized for agentic workflows with custom tools and bash, and quality may fluctuate in use cases that don't benefit from such tools.</cite> Teams running mixed traffic (chat, summarization, tool-driven agents) through one model ID may see uneven results. Use the standard Gemini 3.1 Pro Preview endpoint for tool-free requests, and reserve this one for tool-orchestration steps.
2
Long first-token delay at default thinking. <cite index="29-5">High thinking is the default</cite>, and Artificial Analysis measured about 22.5 to 24.8 seconds to the first answer token on the standard endpoint, versus a 3.76-second median for similar reasoning models. Customtools latency was not measured separately. Interactive, user-facing flows should lower the thinking level or use a faster Gemini Flash model.
3
Weak recall at full context. <cite index="27-13">Figures reported from Google's model card show 84.9% on MRCR v2 (8-needle) at a 128k average, but 26.3% at 1M pointwise.</cite> The 1,048,576-token window fits whole repositories, but retrieval reliability falls at the extreme end. Long-context agents should keep working context well under the limit, or use retrieval, and test needle-style recall on real data.
4
Preview status and text-only output. The endpoint is a public preview, <cite index="9-5">and Vertex AI does not support Provisioned Throughput on it.</cite> <cite index="1-3">Google lists image generation and audio generation as not supported</cite> for the Gemini 3.1 Pro Preview model page, so output is text only. Teams needing guaranteed capacity or generated media need a different model or endpoint.

Best-Fit Workloads

Where this model earns its place

01

Coding agents with mixed tools


This endpoint targets agents that combine bash with registered functions. Google says it better prioritizes tools such as view_file and search_code. At launch, Artificial Analysis measured the standard endpoint at 54% on Terminal-Bench Hard and 59% on SciCode, both reported as top scores then. It fits repository navigation and edit-loop agents. Validate tool choice on your own traces, as customtools was not benchmarked separately.

02

Function-calling orchestration layers


When a planner model must choose among many internal APIs, over-reliance on a generic shell tool wastes steps and weakens control. This endpoint is tuned to favor user-defined functions, and Google lists function calling and structured outputs as supported on the model page. It suits support automation, internal-ops agents, and data-pipeline controllers. Keep deterministic validation on tool arguments.

03

Repository-scale code analysis

‍

A 1,048,576-token context window and a 65,536-token output limit allow multi-file reviews and large refactor plans in one request. The agent can call search and file tools instead of loading everything. Retrieval reliability falls at extreme context length, so keep prompts well below the window for audits where a missed file matters.

04

Multimodal inputs feeding tool calls

‍

The Gemini 3.1 Pro Preview page lists text, image, video, audio and PDF input. That lets an agent read a screenshot, recording or PDF and then act through registered tools, such as filing a ticket or querying a database. Output is text only, so media generation needs another model.

Pricing in anytokens via AnyAPI
Input
12
₳
Output
72
₳
Cache write
2.25
₳
Cache read
1.2
₳

Integration

Access Gemini 3.1 Pro Preview via AnyAPI.ai

Access Gemini 3.1 Pro Preview through AnyAPI.ai using a unified API built for multi-model AI applications. Integrate Gemini 3.1 Pro Preview without maintaining a separate provider-specific connection, and keep the flexibility to test, switch, or combine models as your application requirements evolve.

01

One API integration

Access Gemini 3.1 Pro Preview and other AI models through the same API workflow instead of maintaining separate integrations for every provider.

02

Easy model switching

Test Gemini 3.1 Pro Preview against alternative models or switch models as your performance, capability, or cost requirements change without rebuilding your application around another provider API.

03

Flexible for production

Use Gemini 3.1 Pro Preview from experimentation through production while keeping your AI stack flexible as workloads, traffic, and model requirements evolve.

04

Multi-model applications

Use Gemini 3.1 Pro Preview for the workloads where it performs best and combine it with other models for tasks that require different capabilities, performance, or efficiency.

Frequently Asked Questions

Answers to common questions about integrating and using this AI model via AnyAPI.ai

It is a separate Google API endpoint for Gemini 3.1 Pro Preview. <cite index="1-4,1-5">Google built it for developers mixing bash and custom tools, and it better prioritizes custom tools such as view_file or search_code.</cite> It is in public preview.

The documented difference is tool prioritization, not capacity. <cite index="9-4">Vertex AI states pricing is identical to Gemini 3.1 Pro</cite>, and both list the same token limits. <cite index="1-6">Google warns of quality fluctuations in use cases that don't benefit from custom tools</cite>, so use the standard endpoint for tool-free work.

<cite index="2-3">It has a 1,048,576-token context window and a maximum output of 65,536 tokens.</cite> These are separate limits: the window covers input, while each response is capped at the output limit. Retrieval accuracy reportedly drops near full 1M context, so test long-context recall.

Yes. <cite index="29-4">The thinking_level parameter controls the maximum depth of the model's internal reasoning.</cite> <cite index="29-7,29-9,29-10">Gemini 3.1 Pro supports low, medium and high, with high as the default.</cite> Lower levels reduce latency; high can delay the first output token significantly.

<cite index="9-4">Google documents customtools pricing as identical to Gemini 3.1 Pro</cite>, which sits in the premium Pro tier rather than the low-cost Flash tier. Long outputs and high thinking increase spend. AnyAPI.ai's pricing component on this page shows the current rates for access through AnyAPI.ai.

* Benchmark data source: Artificial Analysis artificialanalysis.ai