google
google/gemini-3.1-pro-preview-customtools

google/gemini-3.1-pro-preview-customtools

Release date: 2026-02-26

1,048,576 context · $2.00/M input tokens · $12.00/M output tokens

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 or user-defined functions are available. This specialized preview endpoint significantly increases function calling reliability and ensures the model selects the most appropriate tool in coding agents and complex, multi-tool workflows. It retains the core strengths of Gemini 3.1 Pro, including multimodal reasoning across text, image, video, audio, and code, a 1M-token context window, and strong software engineering performance.

Pricing

Pay-per-use

No upfront costs, pay only for what you use

Input
> 200K $4.00 / M Tokens
Output
> 200K $18.00 / M Tokens
Cache Read
> 200K $0.40 / M Tokens
Cache Write$0.38 / M Tokens

Try the model

google/gemini-3.1-pro-preview-customtools
Online
google
Hi! I am a helpful AI assistant. What can I do for you?
Ready to use this model in a local coding agent?Agent Setup

API Usage

Use the following code examples to integrate with our API:

import OpenAI from 'openai';

if (!process.env.WAVESPEED_API_KEY) throw new Error('Set WAVESPEED_API_KEY');
const client = new OpenAI({
  apiKey: process.env.WAVESPEED_API_KEY,
  baseURL: 'https://llm.wavespeed.ai/v1',
  timeout: 120_000,
  maxRetries: 0,
});

try {
  const response = await client.chat.completions.create({
    model: 'google/gemini-3.1-pro-preview-customtools',
    messages: [{ role: 'user', content: 'Hello!' }],
  });
  const body = response as typeof response & { error?: { message?: string } };
  if (body.error) throw new Error(body.error.message || 'LLM generation failed');
  console.log(response.choices[0]?.message?.content ?? '');
} catch (error) {
  console.error('LLM request failed:', error);
  process.exitCode = 1;
}

Model Introduction

Google: Gemini 3.1 Pro Preview Custom Tools

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...

This model is available through the WaveSpeed AI OpenAI-compatible API for chat completions and compatible application workflows.


Why It Looks Great

  • text+image+file+audio+video->text architecture for Text, Audio, Image, Video, file to Text workloads
  • 1048576 context window for long prompts, document analysis, and multi-turn workflows
  • Vision input support for image understanding and multimodal tasks
  • Function calling and tool-use support for agentic application workflows
  • Structured output support for JSON responses and schema-constrained generation
  • Reasoning controls available through supported parameters

Key Features

  • Context Window: 1048576 tokens
  • Max Input: 983040 tokens
  • Max Output: 65536 tokens
  • Vision: Supported
  • Function Calling: Supported
  • Structured Outputs: Supported
  • Image Generation: Not listed
  • Audio Input: Supported
  • Supported Parameters: include_reasoning, max_tokens, reasoning, reasoning_effort, response_format, seed, structured_outputs, temperature, tool_choice, tools, top_p

Specifications

SpecificationValue
Providergoogle
Model TypeChat Completions model
Architecturetext+image+file+audio+video->text
Context Window1048576 tokens
Max Input983040 tokens
Max Output65536 tokens
InputText, Audio, Image, Video, file
OutputText
VisionSupported
Function CallingSupported
Structured OutputsSupported
Release DateFebruary 26, 2026

How to Use

  1. Write your prompt - describe the task, provide context, and specify the desired output format.
  2. Submit - the model processes your request and returns the response.

API Integration

Base URL: https://llm.wavespeed.ai/v1 API Endpoint: chat/completions Model ID: google/gemini-3.1-pro-preview-customtools


API Usage

Python SDK

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://llm.wavespeed.ai/v1"
)

response = client.chat.completions.create(
    model="google/gemini-3.1-pro-preview-customtools",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)

cURL

curl https://llm.wavespeed.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "google/gemini-3.1-pro-preview-customtools",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Notes

  • Model: google/gemini-3.1-pro-preview-customtools
  • Provider: google

Info

Providergoogle
Typellm

Supported Functionality

Input
TextImageAudio
Output
Text
Context1,048,576
Max Output65,536
Vision✓ Supported
Function Calling✓ Supported

API Access Guide

Base URLhttps://llm.wavespeed.ai/v1
API Endpointchat/completions
Model IDgoogle/gemini-3.1-pro-preview-customtools

Gemini 3.1 Pro Preview Customtools API

google/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 or user-defined functions are available. This specialized preview endpoint significantly increases function calling reliability and ensures the model selects the most appropriate tool in coding agents and complex, multi-tool workflows. It retains the core strengths of Gemini 3.1 Pro, including multimodal reasoning across text, image, video, audio, and code, a 1M-token context window, and strong software engineering performance.

Input

$2 /M

Output

$12 /M

Context

1049K

Max Output

66K

Vision

Supported

Tool Use

Supported

Try Gemini 3.1 Pro Preview Customtools on WaveSpeedAI

Access Gemini 3.1 Pro Preview Customtools through our unified API — OpenAI-compatible, no cold starts, transparent pricing.

Frequently Asked Questions about Gemini 3.1 Pro Preview Customtools

How much does Gemini 3.1 Pro Preview Customtools cost via the API?+

Pricing on WaveSpeedAI: $2.00 per million input tokens and $12.00 per million output tokens. Prompt caching and batch processing are billed separately and reduce effective cost on long, repetitive workloads.

What is the context window of Gemini 3.1 Pro Preview Customtools?+

Gemini 3.1 Pro Preview Customtools supports up to 1049K tokens of context with up to 66K tokens of output per request.

Is Gemini 3.1 Pro Preview Customtools OpenAI-compatible?+

WaveSpeedAI exposes Gemini 3.1 Pro Preview Customtools at https://llm.wavespeed.ai/v1 through the OpenAI-compatible Chat Completions interface. Most OpenAI SDK clients work by changing the base URL and API key; optional fields depend on the selected model.

How do I get started with Gemini 3.1 Pro Preview Customtools?+

Sign in to WaveSpeedAI, create an API key in Access Keys, then send a request to https://llm.wavespeed.ai/v1/chat/completions with the model id shown above. Check the current model catalog for availability, capabilities, and pricing.

Related LLM APIs