Gemini 3.1 Pro API: Udviklerguide med kodeeksempler (2026)
Komplet udviklerguide til Gemini 3.1 Pro API. Dækker model-ID'er (gemini-3.1-pro-preview-customtools), priser, kodeeksempler i Python og JavaScript, brugerdefinerede værktøjer, funktionskald og integration med din app.
Kort fortalt
| Gemini 3.1 Pro | |
|---|---|
| Model-ID'er | gemini-3.1-pro, gemini-3.1-pro-preview-customtools |
| Kontekstvindue | 1M tokens |
| Inputpris | $2/1M tokens |
| Outputpris | $12/1M tokens |
| Nøglefunktioner | Brugerdefinerede værktøjer, funktionskald, grounding, multimodal (tekst + billede + lyd + video) |
| API | Google AI Studio / Vertex AI |
Gemini 3.1 Pro er Googles seneste frontier-model, udgivet marts 2026. Det er den billigste frontier API per token, har native 1M kontekst og introducerer brugerdefinerede værktøjer — en ny måde at give modellen adgang til eksterne funktioner med strukturerede skemaer.
Model-ID'er
Google tilbyder to varianter af Gemini 3.1 Pro:
| Model-ID | Beskrivelse | Status |
|---|---|---|
gemini-3.1-pro | Stabil udgivelse, generel tilgængelighed | GA |
gemini-3.1-pro-preview-customtools | Preview med forbedret support for brugerdefinerede værktøjer | Preview |
customtools preview-varianten har forbedret pålidelighed for komplekse funktionskaldkæder — brug den hvis din app benytter funktionskald intensivt. Til generel brug anbefales den stabile gemini-3.1-pro.
# Google AI Studio
model = "gemini-3.1-pro"
# Vertex AI
model = "gemini-3.1-pro@001"
Hurtig start: Python
Installation
pip install google-genai
Grundlæggende 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)
Streaming
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="")
Hurtig start: JavaScript
Installation
npm install @google/genai
Grundlæggende 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);
Streaming
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 model API per marts 2026.
| Gemini 3.1 Pro | GPT-5.2 | Claude Sonnet 4.6 | |
|---|---|---|---|
| Input | $2/1M | $5/1M | $3/1M |
| Output | $12/1M | $15/1M | $15/1M |
| Kontekst | 1M | 400K | 1M (beta) |
| Pris per 100K input + 20K output | $0,44 | $0,80 | $0,60 |
I stor skala koster Gemini 3.1 Pro cirka 45 % mindre end GPT-5.2 og 27 % mindre end Sonnet 4.6 per session.
Gratis niveau
Google AI Studio tilbyder et gratis niveau:
- 60 forespørgsler per minut
- 1M tokens per minut
- Intet kreditkort nødvendigt
Dette er det mest generøse gratis API-niveau blandt de tre store udbydere.
Nøglefunktioner
1M Token kontekstvindue
Gemini 3.1 Pro understøtter nativt 1 million tokens kontekst — nok til:
- ~700.000 ord tekst
- ~30.000 linjer kode
- ~1 times video
- ~11 timers lyd
I modsætning til konkurrerende modeller der tilbyder udvidet kontekst som beta-funktion, er Geminis 1M kontekst fuldt GA og prissat som standardkontekst.
Brugerdefinerede værktøjer (funktionskald)
Brugerdefinerede værktøjer lader dig definere eksterne funktioner som Gemini kan kalde under generering. Modellen beslutter hvornår den skal kalde et værktøj, strukturerer argumenterne og inkorporerer resultatet i sit svar.
Det er dette gemini-3.1-pro-preview-customtools-varianten er optimeret til.
Grounding med Google Search
Gemini kan grunde sine svar i real-time Google Search-resultater. Aktivér grounding for at reducere hallucinationer og sikre at modellen bruger aktuel information.
Native multimodal
Behandl tekst, billeder, lyd og video i en enkelt forespørgsel. Ingen separate vision- eller lydmodeller — Gemini håndterer alle modaliteter nativt.
Kodeeksempel: Brugerdefinerede værktøjer / Funktionskald
Dette eksempel opretter et vejrværktøj som Gemini kan kalde for at få aktuelle 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 (billede + 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
| Funktion | Gemini 3.1 Pro | GPT-5.2 | Claude Sonnet 4.6 |
|---|---|---|---|
| Inputpris | $2/1M | $5/1M | $3/1M |
| Outputpris | $12/1M | $15/1M | $15/1M |
| Kontekstvindue | 1M (GA) | 400K | 1M (beta) |
| Funktionskald | Ja (brugerdefinerede værktøjer) | Ja | Ja (tool use) |
| Multimodal | Tekst + billede + lyd + video | Tekst + billede + lyd | Tekst + billede |
| Grounding | Google Search | Webbrowsing | Ingen native grounding |
| Streaming | Ja | Ja | Ja |
| Batch API | Ja | Ja | Ja |
| Gratis niveau | 60 RPM, 1M TPM | Begrænset | Begrænset |
| SDK-sprog | Python, JS, Go, Dart, Swift | Python, JS | Python, JS |
| Kodning (SWE-bench) | 76,8 % | 80,0 % | 79,6 % |
| Computerbrug | N/A | 38,2 % | 72,5 % |
| Matematik (AIME) | ~88 % | 100 % | ~90 % |
Hvornår vælge hvilket API
Vælg Gemini 3.1 Pro når:- Pris er en primær bekymring (billigste frontier API)
- Du behøver native video- eller lydbehandling
- Du behøver 1M kontekst i produktion (GA, ikke beta)
- Du vil have Google Search grounding
- Du bygger på Google Cloud
- Matematisk tung ræsonnering er kritisk
- Du er i OpenAI-økosystemet
- Du behøver strukturerede outputs med garanterede JSON-skemaer
- Hastighed på simple forespørgsler er vigtigst
- Kodning og agentiske opgaver er primært use case
- Du behøver computerbrug / browserautomatisering
- Kontorproduktivitetsopgaver (dokumenter, regneark)
- Prompt injection-modstand er vigtig (agentsikkerhed)
Integration af Gemini 3.1 Pro med din app
Brug med Y Build
Hvis du bygger et produkt med Y Build, kan du integrere Gemini API direkte i din backend. Y Build-projekter deployes til Cloudflare Workers, som kan kalde 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));
}
Rate limits
| Niveau | Forespørgsler/min | Tokens/min |
|---|---|---|
| Gratis | 60 | 1.000.000 |
| Pay-as-you-go | 1.000 | 4.000.000 |
| Enterprise | Tilpasset | Tilpasset |
Ofte stillede spørgsmål
Hvad er gemini-3.1-pro-preview-customtools?
Det er en preview-variant af Gemini 3.1 Pro optimeret til brugerdefinerede værktøjer og funktionskald. Den har forbedret pålidelighed når modellen skal kæde flere værktøjskald sammen. Brug den hvis din app er stærkt afhængig af funktionskald. Til generel tekstgenerering brug det stabile model-ID gemini-3.1-pro.
Er Gemini 3.1 Pro bedre end GPT-5.2?
Det afhænger af opgaven. Gemini 3.1 Pro er billigere, har et større kontekstvindue og understøtter flere modaliteter (video, lyd). GPT-5.2 scorer højere på kodningsbenchmarks og matematisk ræsonnering. Til multimodale apps med budget vinder Gemini. Til rene ræsonneringsopgaver leder GPT-5.2.
Hvordan sammenligner Gemini 3.1 Pro sig med Claude Sonnet 4.6?
Gemini er billigere ($2/$12 vs $3/$15 per million tokens) og har native video/lyd-support. Claude Sonnet 4.6 er bedre til kodning (79,6 % vs 76,8 % på SWE-bench), computerbrug (72,5 % vs N/A) og kontorarbejde. Vælg Gemini for multimodal og pris. Vælg Claude for kodning og agenter.
Kan jeg bruge Gemini 3.1 Pro gratis?
Ja. Google AI Studio tilbyder et gratis niveau med 60 forespørgsler per minut og 1 million tokens per minut. Intet kreditkort nødvendigt. Det er tilstrækkeligt til udvikling, test og produktionsapps med lav trafik.
Hvad er forskellen mellem Google AI Studio og Vertex AI?
Google AI Studio er det enklere, udviklerorienterede API — tilmeld dig med en API-nøgle og begynd at kalde. Vertex AI er enterprise-platformen — kører på Google Cloud, tilbyder fine-tuning, model deployment, overvågning og SLA'er. Samme model, forskellige wrappers. Start med AI Studio, flyt til Vertex AI når du behøver enterprise-funktioner.
Bundlinjen
Gemini 3.1 Pro er det bedste frontier API for pengene i marts 2026. Til $2/$12 per million tokens koster det omtrent halvdelen af GPT-5.2 og en tredjedel mindre end Claude Sonnet 4.6 — med native 1M kontekst og den bredeste multimodale support.
For udviklere der bygger AI-drevne produkter, er det praktiske råd: brug Gemini til multimodale og omkostningsfølsomme opgaver, Claude til kodning og agenter, og GPT-5.2 til matematisk tung ræsonnering. Modelrouting på tværs af alle tre giver dig det bedste af hver.
Bygger du et AI-drevet produkt? Y Build håndterer hele stakken — AI-kodning, one-click deploy til Cloudflare, Demo Cut til produktvideoer, AI SEO og analytics. Integrér Gemini, Claude eller GPT API'er i din app og lever 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.