Gemini 3.1 Pro Preview Customtools
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…
gemini-3.1-pro-preview-customtoolsReleased 25 Feb 2026 (Feb 2026)Pricing
List prices at Google AI Studio, in US dollars per million tokens.
| Tier | Input / 1M | Output / 1M | |
|---|---|---|---|
| Standard | $2.00 | $12.00 | |
| Cached input 90% off input | $0.20 | 90% off input | |
| Batch 50% off | $1.00 | $6.00 | 50% off |
| Flex 50% off | $1.00 | $6.00 | 50% off |
| Priority 80% more | $3.60 | $21.60 | 80% more |
| Prompts over 200K tokens | $4.00 | $18.00 | |
| Web search $14.00 per 1,000 searches | $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
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.
| Host | In / out per 1M | Model id | |
|---|---|---|---|
Google AI StudioLab API gemini-3.1-pro-preview-customtools | $2.00 / $12.00 | gemini-3.1-pro-preview-customtools | |
Vertex AICloud gemini-3.1-pro-preview-customtools | $2.00 / $12.00 | gemini-3.1-pro-preview-customtools | |
AIHubMixGateway gemini-3.1-pro-preview-customtools | $2.00 / $12.00 | gemini-3.1-pro-preview-customtools |
Show 1 more listings: regions, snapshots and variantsHide regional listings
| Vertex AI | |||||||
| Alias gemini-3.1-pro-preview-customtools | $2.00 / $12.00 | gemini-3.1-pro-preview-customtools | |||||
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
- 11% less
- 11% less
- 33% less
Other frontier labs
- 11% less
- 11% less
- 33% less
- 56% less
Open-weight picks
- 11% less
- 50% less
- 62% less
- 88% less
Call it
Using Google AI Studio's API.
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)curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.1-pro-preview-customtools:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents": [{"parts": [{"text": "Hello"}]}]}'from litellm import completion
response = completion(
model="gemini/gemini-3.1-pro-preview-customtools",
messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)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
}