Gemini 3.1 Pro Preview Custom Tools API

google/gemini-3.1-pro-preview-customtools
Gemini 3.1 Pro Preview Custom Tools on AIMLAPI.
Context
1M tokens
Input
$2.116 / 1M tokens
Output
$12.696 / 1M tokens
Released
Feb 25, 2026

Overview

What is Gemini 3.1 Pro Preview Custom Tools API?

Gemini 3.1 Pro Preview Custom Tools is available through AIMLAPI.

Technical Specifications
- Supported inputs: Image, Text
- Output: Text
- Context window: 1,048,756 tokens / Max output: 65,536 tokens
- Endpoint: /chat/completions

Performance Benchmarks
[embed]

Gemini 3.1 Pro Preview Custom Tools API Pricing
- Input: $2.6 / 1M tokens
- Output: $15.6 / 1M tokens

Where to Use Gemini 3.1 Pro Preview Custom Tools

Coding and code review
Generate, debug, and review code across languages, reading whole files or repos in a single prompt.

Agentic and multi-step workflows
Reliable tool-calling and instruction-following suit agent loops that plan, call tools, and iterate.

Complex reasoning
Extended reasoning improves reliability on multi-step math, logic, and technical analysis.

Long-document analysis
Summarize and extract from contracts, papers, and reports without aggressive chunking.

Code Sample
[embed]

Uptime and performance

  • Uptime (7d): 100%

Measured on the AI/ML API gateway across live traffic. Figures are medians unless stated. Last updated 2026-10-12.

Use cases

Gemini 3.1 Pro Preview Custom Tools is suited to agentic workflows that use custom tools and bash, especially when the model should prioritize registered custom tools like file or code-search tools.

It is documented as a good fit for AI coding assistants that rely on structured tools such as file viewing and editing, rather than defaulting to bash.

It is also suited to DevOps agents that need to call CI/CD systems through tools, as well as MCP workflows that orchestrate multi-step tool-based processes.

Another documented use case is agent applications that require permission-controlled tools and structured logging for auditing or compliance.

How to use Gemini 3.1 Pro Preview Custom Tools API

Install any OpenAI-compatible SDK, point it at api.aimlapi.com/v1, and set the model to google/gemini-3.1-pro-preview-customtools.
import requests

r = requests.post(
    "https://api.aimlapi.com/v1/chat/completions",
    headers={"Authorization": "Bearer " + AIMLAPI_KEY},
    json={
      "model": "google/gemini-3.1-pro-preview-customtools",
      "messages": [
        {
          "role": "user",
          "content": "Hello!"
        }
      ]
    },
)
print(r.json())
const r = await fetch("https://api.aimlapi.com/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.AIMLAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "google/gemini-3.1-pro-preview-customtools",
    "messages": [
      {
        "role": "user",
        "content": "Hello!"
      }
    ]
  }),
});
console.log(await r.json());
curl -X POST https://api.aimlapi.com/v1/chat/completions \
  -H "Authorization: Bearer $AIMLAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"google/gemini-3.1-pro-preview-customtools","messages":[{"role":"user","content":"Hello!"}]}'

OpenAI-compatible — swap the base URL and it works with your existing SDK.

Gemini 3.1 Pro Preview Custom Tools API Pricing

TypePrice
Input
$2.116 / 1M tokens
Output
$12.696 / 1M tokens
Cached input
$0.2116 / 1M tokens

Gemini 3.1 Pro Preview Custom Tools vs other models

ModelInputOutputContextBest for
$2.116 / 1M tokens
$12.696 / 1M tokens
1M tokens
Reasoning + agents
$5 / 1M tokens
$30 / 1M tokens
1M tokens
Reasoning + agents
$2 / 1M tokens
$10 / 1M tokens
1M tokens
Balanced coding + agents
$3 / 1M tokens
$15 / 1M tokens
1M tokens
Long-context, multimodal & agentic workflows
$1.5 / 1M tokens
$9 / 1M tokens
1M tokens
Reasoning + agents

Frequently asked questions

Gemini 3.1 Pro Preview Custom Tools has a 1,048,756 tokens context window and can return up to 65,536 tokens.

Gemini 3.1 Pro Preview Custom Tools takes image, text as input and returns text.

Use google/gemini-3.1-pro-preview-customtools as the model id. Requests go to https://api.aimlapi.com/v1/chat/completions.

Gemini 3.1 Pro Preview Custom Tools is priced at input $2.7508 / 1M tokens, output $16.5048 / 1M tokens, cached input $0.27508 / 1M tokens.

Yes, Gemini 3.1 Pro Preview Custom Tools can stream responses as they are generated.

Yes, Gemini 3.1 Pro Preview Custom Tools accepts image input alongside text.

Gemini 3.1 Pro Preview Custom Tools was built by Google.

It supports function calling, reasoning, structured outputs, web search, and parallel tool calls, making it suited for tasks that combine multi-step reasoning with tool use.

Start building with Gemini 3.1 Pro Preview Custom Tools

Get API Key
1000+ models, one API.