impulse

Gemini 3.1 Pro Preview Customtools

Frontier labPreview

Gemini 3.1 Pro Preview Custom Tools is a variant of Gemini 3.1 Pro that improves tool selection behavior by preventing overuse of a general bash tool when more efficient third-party…

API id gemini-3.1-pro-preview-customtoolsReleased 25 Feb 2026 (Feb 2026)
Input / 1M
$2.00
at Google AI Studio
Output / 1M
$12.00
at Google AI Studio
Context window
1M
tokens
Max output
66K
tokens per reply
Hosts
3
4 listings
Released
Feb 2026
25 Feb 2026

Pricing

List prices at Google AI Studio, in US dollars per million tokens.

TierInput / 1MOutput / 1M
Standard$2.00$12.00
Cached input
90% off input
$0.20
Batch
50% off
$1.00$6.00
Flex
50% off
$1.00$6.00
Priority
80% more
$3.60$21.60
Prompts over 200K tokens$4.00$18.00
Web search
$14.00 per 1,000 searches

What it costs a month

At Google AI Studio list prices, 30 days.

  • Chat assistant5,000 requests a day, 2K in / 0.5K out, cached$1,338
  • RAG over documents2,000 requests a day, 8K in / 0.6K out, cached$960
  • Coding agent1,000 requests a day, 40K in / 2K out, cached$1,608
  • Overnight batch20,000 requests a day, 4K in / 0.4K out, batch$3,840
Use your own numbers

Where to run it

3 hosts serve Gemini 3.1 Pro Preview Customtools. The comparison is on blended price, 3 parts input to 1 part output.

HostIn / out per 1M
gemini-3.1-pro-preview-customtools
$2.00 / $12.00
gemini-3.1-pro-preview-customtools
$2.00 / $12.00
AIHubMixGateway
gemini-3.1-pro-preview-customtools
$2.00 / $12.00
Show 1 more listings: regions, snapshots and variants
Vertex AI
Alias
gemini-3.1-pro-preview-customtools
$2.00 / $12.00

Capabilities

Core

  • Streaming
  • Function calling
  • JSON mode
  • Structured outputs

Multimodal

  • Vision
  • Image input
  • Audio
  • Image generation
  • Video

Advanced

  • Reasoning
  • Tool calling
  • MCP
  • Prompt caching
  • Batch API
  • Embeddings
Takes in
AudioImagesTextVideoPDFs
Produces
Text
Features
Audio inputPDF inputPrompt cachingURL contextVideo inputBuilt-in web search

Cheaper alternatives

Current models that cost less and keep most of what this one can do: tools, vision, reasoning, structured output, caching and enough context.

Same model, cheaper host

No host sells it for less than Google AI Studio.

Smaller Google models

  • Gemini 4 Carbon
    Google · on Google AI Studio
    $2.00 / $10.00
    Has every key capability
    11% less
  • Gemini 4 Argon
    Google · on Google AI Studio
    $2.00 / $10.00
    Has every key capability
    11% less
  • Gemini 4 Hydrogen
    Google · on Google AI Studio
    $1.50 / $7.50
    Has every key capability
    33% less

Other frontier labs

  • GPT-6.2 Sol
    OpenAI · on OpenAI
    $2.00 / $10.00
    Has every key capability
    11% less
  • Claude Sonnet 5.5
    Anthropic · on Anthropic
    $2.00 / $10.00
    Has every key capability
    11% less
  • Grok 4.7
    xAI · on xAI
    $2.00 / $6.00
    Has every key capability
    33% less
  • GPT-6.1 Terra
    OpenAI · on OpenAI
    $1.00 / $5.00
    Has every key capability
    56% less

Open-weight picks

  • Kimi K3.1 Pro
    Moonshot AI · on Databricks
    $2.00 / $10.00
    Has every key capability
    11% less
  • Qwen4 Max
    Alibaba Qwen · on Alibaba DashScope
    $1.50 / $4.50
    Has every key capability
    50% less
  • Inkling
    Independent · on DeepInfra
    $0.95 / $4.05
    Has every key capability
    62% less
  • DeepSeek Flash
    DeepSeek · on DeepSeek
    $0.30 / $1.20
    Has every key capability
    88% less

Call it

Using Google AI Studio's API.

Python
from google import genai

client = genai.Client()  # reads GEMINI_API_KEY

response = client.models.generate_content(model="gemini-3.1-pro-preview-customtools", contents="Hello")
print(response.text)

Quick answers

How much does Gemini 3.1 Pro Preview Customtools cost?

On Google AI Studio, Gemini 3.1 Pro Preview Customtools costs $2.00 per million input tokens and $12.00 per million output tokens. Cached input costs $0.20 per million tokens.

Which APIs offer Gemini 3.1 Pro Preview Customtools?

Gemini 3.1 Pro Preview Customtools runs on 3 APIs: Google AI Studio, Vertex AI and AIHubMix.

What is Gemini 3.1 Pro Preview Customtools's context window?

1M tokens, with up to 66K tokens in one reply.

Is Gemini 3.1 Pro Preview Customtools being retired?

No retirement date is scheduled for it on any API we track.

What are cheaper alternatives to Gemini 3.1 Pro Preview Customtools?

Models that cost less and keep most of what it can do: Gemini 4 Carbon on Google AI Studio (11% less), GPT-6.2 Sol on OpenAI (11% less), Claude Sonnet 5.5 on Anthropic (11% less) and Kimi K3.1 Pro on Databricks (11% less). Savings are on a mix of 3 input tokens to 1 output token.

When was Gemini 3.1 Pro Preview Customtools released?

Google released it on 25 Feb 2026.

What is Gemini 3.1 Pro Preview Customtools's API model id?

Use gemini-3.1-pro-preview-customtools with Google AI Studio.

Sources

Raw catalog entry for gemini-3.1-pro-preview-customtools on Google AI Studio
{
  "prompt_cache_min_tokens": 4096,
  "cache_read_input_token_cost": 2e-7,
  "cache_read_input_token_cost_above_200k_tokens": 4e-7,
  "input_cost_per_token": 0.000002,
  "input_cost_per_token_above_200k_tokens": 0.000004,
  "input_cost_per_token_batches": 0.000001,
  "litellm_provider": "gemini",
  "max_input_tokens": 1048576,
  "max_output_tokens": 65536,
  "mode": "chat",
  "output_cost_per_token": 0.000012,
  "output_cost_per_token_above_200k_tokens": 0.000018,
  "output_cost_per_token_batches": 0.000006,
  "rpm": 2000,
  "source": "https://ai.google.dev/gemini-api/docs/pricing",
  "supported_endpoints": [
    "/v1/chat/completions",
    "/v1/completions",
    "/v1/batch"
  ],
  "supported_modalities": [
    "text",
    "image",
    "audio",
    "video"
  ],
  "supported_output_modalities": [
    "text"
  ],
  "supports_audio_input": true,
  "supports_function_calling": true,
  "supports_pdf_input": true,
  "supports_prompt_caching": true,
  "supports_reasoning": true,
  "supports_response_schema": true,
  "supports_system_messages": true,
  "supports_tool_choice": true,
  "supports_video_input": true,
  "supports_vision": true,
  "supports_web_search": true,
  "supports_url_context": true,
  "supports_native_streaming": true,
  "tpm": 800000,
  "input_cost_per_token_priority": 0.0000036,
  "input_cost_per_token_above_200k_tokens_priority": 0.0000072,
  "output_cost_per_token_priority": 0.0000216,
  "output_cost_per_token_above_200k_tokens_priority": 0.0000324,
  "cache_read_input_token_cost_priority": 3.6e-7,
  "cache_read_input_token_cost_above_200k_tokens_priority": 7.2e-7,
  "cache_read_input_token_cost_batches": 2e-7,
  "cache_read_input_token_cost_flex": 2e-7,
  "search_context_cost_per_query": {
    "search_context_size_low": 0.014,
    "search_context_size_medium": 0.014,
    "search_context_size_high": 0.014
  },
  "search_free_requests": {
    "count": 5000,
    "period": "month",
    "shared_group": "gemini-3"
  },
  "web_search_billing_unit": "per_query",
  "google_maps_grounding_cost_per_query": 0.014,
  "input_cost_per_token_flex": 0.000001,
  "output_cost_per_token_flex": 0.000006,
  "cache_read_input_token_cost_above_200k_tokens_batches": 4e-7,
  "cache_read_input_token_cost_above_200k_tokens_flex": 4e-7,
  "input_cost_per_token_above_200k_tokens_batches": 0.000002,
  "input_cost_per_token_above_200k_tokens_flex": 0.000002,
  "output_cost_per_token_above_200k_tokens_batches": 0.000009,
  "output_cost_per_token_above_200k_tokens_flex": 0.000009
}