Gemini 3.1 Pro API: Utviklerguide med Kodeeksempler (2026)
Komplett utviklerguide for Gemini 3.1 Pro API. Dekker modell-ID-er (gemini-3.1-pro-preview-customtools), priser, kodeeksempler i Python og JavaScript, egendefinerte verktøy, funksjonskalling og integrasjon med appen din.
Sammendrag
| Gemini 3.1 Pro | |
|---|---|
| Modell-ID-er | gemini-3.1-pro, gemini-3.1-pro-preview-customtools |
| Kontekstvindu | 1M tokens |
| Inngangspris | $2/1M tokens |
| Utgangspris | $12/1M tokens |
| Nøkkelfunksjoner | Egendefinerte verktøy, funksjonskalling, grounding, multimodal (tekst + bilde + lyd + video) |
| API | Google AI Studio / Vertex AI |
Gemini 3.1 Pro er Googles nyeste frontier-modell, utgitt mars 2026. Det er den billigste frontier-API-en per token, har nativ 1M kontekst og introduserer egendefinerte verktøy — en ny måte å gi modellen tilgang til eksterne funksjoner med strukturerte skjemaer.
Modell-ID-er
Google tilbyr to varianter av Gemini 3.1 Pro:
| Modell-ID | Beskrivelse | Status |
|---|---|---|
gemini-3.1-pro | Stabil utgivelse, generell tilgjengelighet | GA |
gemini-3.1-pro-preview-customtools | Forhåndsvisning med forbedret støtte for egendefinerte verktøy | Preview |
customtools forhåndsvisningsvarianten har forbedret pålitelighet for komplekse funksjonskallkjeder — bruk den hvis appen din bruker verktøykalling mye. For generell bruk anbefales den stabile gemini-3.1-pro.
# Google AI Studio
model = "gemini-3.1-pro"
# Vertex AI
model = "gemini-3.1-pro@001"
Hurtigstart: Python
Installasjon
pip install google-genai
Grunnleggende Tekstgenerering
from google import genai
client = genai.Client(api_key="YOUR_API_KEY")
response = client.models.generate_content(
model="gemini-3.1-pro",
contents="Explain quantum computing in 3 sentences."
)
print(response.text)
Strømming
for chunk in client.models.generate_content_stream(
model="gemini-3.1-pro",
contents="Write a Python function to merge two sorted arrays."
):
print(chunk.text, end="")
Hurtigstart: JavaScript
Installasjon
npm install @google/genai
Grunnleggende Tekstgenerering
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });
const response = await ai.models.generateContent({
model: "gemini-3.1-pro",
contents: "Explain quantum computing in 3 sentences.",
});
console.log(response.text);
Strømming
const stream = await ai.models.generateContentStream({
model: "gemini-3.1-pro",
contents: "Write a JavaScript function to merge two sorted arrays.",
});
for await (const chunk of stream) {
process.stdout.write(chunk.text);
}
Be first to build with AI
Y Build is the AI-era operating system for startups. Join the waitlist and get early access.
Priser
Gemini 3.1 Pro er den billigste frontier-modell-API-en per mars 2026.
| Gemini 3.1 Pro | GPT-5.2 | Claude Sonnet 4.6 | |
|---|---|---|---|
| Inngang | $2/1M | $5/1M | $3/1M |
| Utgang | $12/1M | $15/1M | $15/1M |
| Kontekst | 1M | 400K | 1M (beta) |
| Kostnad per 100K inn + 20K ut | $0,44 | $0,80 | $0,60 |
I skala koster Gemini 3.1 Pro omtrent 45% mindre enn GPT-5.2 og 27% mindre enn Sonnet 4.6 per økt.
Gratis Plan
Google AI Studio tilbyr et gratis plan:
- 60 forespørsler per minutt
- 1M tokens per minutt
- Ingen kredittkort kreves
Dette er det mest generøse gratis API-planet blant de tre store leverandørene.
Nøkkelfunksjoner
1M Token Kontekstvindu
Gemini 3.1 Pro støtter nativt 1 million tokens kontekst — nok til:
- ~700 000 ord med tekst
- ~30 000 linjer med kode
- ~1 time video
- ~11 timer lyd
I motsetning til konkurrerende modeller som tilbyr utvidet kontekst som betafunksjon, er Geminis 1M kontekst fullt GA og priset likt som standardkontekst.
Egendefinerte Verktøy (Funksjonskalling)
Egendefinerte verktøy lar deg definere eksterne funksjoner som Gemini kan kalle under generering. Modellen bestemmer når den skal kalle et verktøy, strukturerer argumentene og innlemmer resultatet i svaret sitt.
Dette er hva gemini-3.1-pro-preview-customtools-varianten er optimalisert for.
Grounding med Google Søk
Gemini kan basere svarene sine på sanntids Google Søk-resultater. Aktiver grounding for å redusere hallusinasjoner og sikre at modellen bruker oppdatert informasjon.
Nativ Multimodal
Prosesser tekst, bilder, lyd og video i en enkelt forespørsel. Ingen separate visjon- eller lydmodeller — Gemini håndterer alle modaliteter nativt.
Kodeeksempel: Egendefinerte Verktøy / Funksjonskalling
Dette eksempelet oppretter et værverktøy som Gemini kan kalle for å hente gjeldende forhold.
Python
from google import genai
from google.genai import types
client = genai.Client(api_key="YOUR_API_KEY")
# Define the tool
weather_tool = types.Tool(
function_declarations=[
types.FunctionDeclaration(
name="get_weather",
description="Get the current weather for a city",
parameters=types.Schema(
type=types.Type.OBJECT,
properties={
"city": types.Schema(
type=types.Type.STRING,
description="City name, e.g. 'San Francisco'"
),
"unit": types.Schema(
type=types.Type.STRING,
enum=["celsius", "fahrenheit"],
description="Temperature unit"
),
},
required=["city"],
),
)
]
)
# Send request with tool
response = client.models.generate_content(
model="gemini-3.1-pro-preview-customtools",
contents="What's the weather like in Tokyo?",
config=types.GenerateContentConfig(
tools=[weather_tool],
),
)
# Check if the model wants to call a function
for part in response.candidates[0].content.parts:
if part.function_call:
print(f"Function: {part.function_call.name}")
print(f"Arguments: {part.function_call.args}")
# Output:
# Function: get_weather
# Arguments: {'city': 'Tokyo', 'unit': 'celsius'}
# In production, you'd call your actual weather API here,
# then send the result back to Gemini for a natural language response.
JavaScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });
const weatherTool = {
functionDeclarations: [
{
name: "get_weather",
description: "Get the current weather for a city",
parameters: {
type: "OBJECT",
properties: {
city: {
type: "STRING",
description: "City name, e.g. 'San Francisco'",
},
unit: {
type: "STRING",
enum: ["celsius", "fahrenheit"],
description: "Temperature unit",
},
},
required: ["city"],
},
},
],
};
const response = await ai.models.generateContent({
model: "gemini-3.1-pro-preview-customtools",
contents: "What's the weather like in Tokyo?",
config: {
tools: [weatherTool],
},
});
// Check for function calls in the response
for (const part of response.candidates[0].content.parts) {
if (part.functionCall) {
console.log(`Function: ${part.functionCall.name}`);
console.log(`Arguments:`, part.functionCall.args);
}
}
Kodeeksempel: Multimodal (Bilde + Tekst)
Python
from google import genai
from google.genai import types
import base64
client = genai.Client(api_key="YOUR_API_KEY")
# Read a local image
with open("screenshot.png", "rb") as f:
image_data = f.read()
response = client.models.generate_content(
model="gemini-3.1-pro",
contents=[
types.Content(
parts=[
types.Part(text="What's in this screenshot? Describe the UI elements."),
types.Part(
inline_data=types.Blob(
mime_type="image/png",
data=image_data,
)
),
]
)
],
)
print(response.text)
JavaScript
import { GoogleGenAI } from "@google/genai";
import fs from "fs";
const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });
const imageData = fs.readFileSync("screenshot.png");
const base64Image = imageData.toString("base64");
const response = await ai.models.generateContent({
model: "gemini-3.1-pro",
contents: [
{
parts: [
{ text: "What's in this screenshot? Describe the UI elements." },
{
inlineData: {
mimeType: "image/png",
data: base64Image,
},
},
],
},
],
});
console.log(response.text);
API-sammenligning: Gemini 3.1 Pro vs GPT-5.2 vs Claude Sonnet 4.6
| Funksjon | Gemini 3.1 Pro | GPT-5.2 | Claude Sonnet 4.6 |
|---|---|---|---|
| Inngangspris | $2/1M | $5/1M | $3/1M |
| Utgangspris | $12/1M | $15/1M | $15/1M |
| Kontekstvindu | 1M (GA) | 400K | 1M (beta) |
| Funksjonskalling | Ja (egendefinerte verktøy) | Ja | Ja (tool use) |
| Multimodal | Tekst + bilde + lyd + video | Tekst + bilde + lyd | Tekst + bilde |
| Grounding | Google Søk | Nettlesing | Ingen nativ grounding |
| Strømming | Ja | Ja | Ja |
| Batch API | Ja | Ja | Ja |
| Gratis plan | 60 RPM, 1M TPM | Begrenset | Begrenset |
| SDK-språk | Python, JS, Go, Dart, Swift | Python, JS | Python, JS |
| Koding (SWE-bench) | 76,8% | 80,0% | 79,6% |
| Datamaskinbruk | N/A | 38,2% | 72,5% |
| Matte (AIME) | ~88% | 100% | ~90% |
Når Velge Hver API
Velg Gemini 3.1 Pro når:- Kostnad er en primær bekymring (billigste frontier-API)
- Du trenger nativ video- eller lydbehandling
- Du trenger 1M kontekst i produksjon (GA, ikke beta)
- Du vil ha Google Søk grounding
- Du bygger på Google Cloud
- Matematisk resonnering er kritisk
- Du er i OpenAI-økosystemet
- Du trenger strukturerte utdata med garanterte JSON-skjemaer
- Hastighet på enkle spørringer er viktigst
- Koding og agentoppgaver er det primære brukstilfellet
- Du trenger datamaskinbruk / nettleserautomatisering
- Kontorproduktivitetsoppgaver (dokumenter, regneark)
- Motstandsdyktighet mot prompt injection er viktig (agentsikkerhet)
Integrere Gemini 3.1 Pro med Appen Din
Bruke med Y Build
Hvis du bygger et produkt med Y Build, kan du integrere Gemini API direkte i backend-en din. Y Build-prosjekter deployes til Cloudflare Workers, som kan kalle Gemini API med lav latens.
// In a Y Build project (Cloudflare Worker)
export async function onRequest(context) {
const response = await fetch(
"https://generativelanguage.googleapis.com/v1beta/models/gemini-3.1-pro:generateContent",
{
method: "POST",
headers: {
"Content-Type": "application/json",
"x-goog-api-key": context.env.GEMINI_API_KEY,
},
body: JSON.stringify({
contents: [{ parts: [{ text: "Your prompt here" }] }],
}),
}
);
const data = await response.json();
return new Response(JSON.stringify(data));
}
Hastighetsgrenser
| Nivå | Forespørsler/min | Tokens/min |
|---|---|---|
| Free | 60 | 1 000 000 |
| Pay-as-you-go | 1 000 | 4 000 000 |
| Enterprise | Tilpasset | Tilpasset |
Ofte Stilte Spørsmål
Hva er gemini-3.1-pro-preview-customtools?
Det er en forhåndsvisningsvariant av Gemini 3.1 Pro optimalisert for egendefinerte verktøy og funksjonskalling. Den har forbedret pålitelighet når modellen trenger å kjede flere verktøykall sammen. Bruk den hvis appen din er sterkt avhengig av funksjonskalling. For generell tekstgenerering, bruk den stabile gemini-3.1-pro modell-ID-en.
Er Gemini 3.1 Pro bedre enn GPT-5.2?
Det avhenger av oppgaven. Gemini 3.1 Pro er billigere, har et større kontekstvindu og støtter flere modaliteter (video, lyd). GPT-5.2 scorer høyere på kodings-benchmarks og matematisk resonnering. For multimodale apper med budsjett vinner Gemini. For rene resonneringsoppgaver leder GPT-5.2.
Hvordan sammenligner Gemini 3.1 Pro seg med Claude Sonnet 4.6?
Gemini er billigere ($2/$12 vs $3/$15 per million tokens) og har nativ video/lydstøtte. Claude Sonnet 4.6 er bedre på koding (79,6% vs 76,8% på SWE-bench), datamaskinbruk (72,5% vs N/A) og kontoroppgaver. Velg Gemini for multimodal og kostnad. Velg Claude for koding og agenter.
Kan jeg bruke Gemini 3.1 Pro gratis?
Ja. Google AI Studio tilbyr et gratis plan med 60 forespørsler per minutt og 1 million tokens per minutt. Ingen kredittkort kreves. Dette er tilstrekkelig for utvikling, testing og produksjonsapper med lavt trafikk.
Hva er forskjellen mellom Google AI Studio og Vertex AI?
Google AI Studio er den enklere, utviklerfokuserte API-en — registrer deg med en API-nøkkel og begynn å kalle. Vertex AI er enterprise-plattformen — kjører på Google Cloud, tilbyr finjustering, modell-deployment, overvåking og SLA-er. Samme modell, forskjellige innpakninger. Start med AI Studio, gå over til Vertex AI når du trenger enterprise-funksjoner.
Konklusjonen
Gemini 3.1 Pro er den beste verdi frontier-API-en i mars 2026. Med $2/$12 per million tokens koster det omtrent halvparten av GPT-5.2 og en tredjedel mindre enn Claude Sonnet 4.6 — med nativ 1M kontekst og den bredeste multimodale støtten.
For utviklere som bygger AI-drevne produkter er det praktiske rådet: bruk Gemini for multimodale og kostnadssensitive oppgaver, Claude for koding og agenter, og GPT-5.2 for matematisk resonnering. Modellruting på tvers av alle tre gir deg det beste fra hver.
Bygger du et AI-drevet produkt? Y Build håndterer hele stacken — AI-assistert koding, ett-klikks deploy til Cloudflare, Demo Cut for produktvideoer, AI SEO og analyse. Integrer Gemini, Claude eller GPT API-er i appen din og lanser på timer. Start gratis.
Kilder:
Be first to build with AI
Y Build is the AI-era operating system for startups. Join the waitlist and get early access.