Gemini 3.1 Pro API: Kehittäjäopas koodiesimerkeillä (2026)
Täydellinen kehittäjäopas Gemini 3.1 Pro API:lle. Kattaa malli-ID:t (gemini-3.1-pro-preview-customtools), hinnoittelun, koodiesimerkit Pythonilla ja JavaScriptillä, mukautetut työkalut, funktiokutsut ja integroinnin sovellukseesi.
Tiivistelmä
| Gemini 3.1 Pro | |
|---|---|
| Malli-ID:t | gemini-3.1-pro, gemini-3.1-pro-preview-customtools |
| Konteksti-ikkuna | 1M tokenia |
| Syötehinta | $2/1M tokenia |
| Tulostehinta | $12/1M tokenia |
| Avainominaisuudet | Mukautetut työkalut, funktiokutsut, grounding, multimodaalinen (teksti + kuva + ääni + video) |
| API | Google AI Studio / Vertex AI |
Gemini 3.1 Pro on Googlen uusin frontier-malli, julkaistu maaliskuussa 2026. Se on halvin frontier-API per tokeni, sillä on natiivi 1M konteksti, ja se esittelee mukautetut työkalut — uusi tapa antaa mallille pääsy ulkoisiin funktioihin strukturoitujen skeemojen avulla.
Malli-ID:t
| Malli-ID | Kuvaus | Tila |
|---|---|---|
gemini-3.1-pro | Vakaa julkaisu, yleinen saatavuus | GA |
gemini-3.1-pro-preview-customtools | Esikatselu parannetulla mukautettujen työkalujen tuella | Preview |
# Google AI Studio
model = "gemini-3.1-pro"
# Vertex AI
model = "gemini-3.1-pro@001"
Nopea aloitus: Python
pip install google-genai
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)
Nopea aloitus: JavaScript
npm install @google/genai
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);
Be first to build with AI
Y Build is the AI-era operating system for startups. Join the waitlist and get early access.
Hinnoittelu
| Gemini 3.1 Pro | GPT-5.2 | Claude Sonnet 4.6 | |
|---|---|---|---|
| Syöte | $2/1M | $5/1M | $3/1M |
| Tuloste | $12/1M | $15/1M | $15/1M |
| Konteksti | 1M | 400K | 1M (beta) |
| Kustannus per 100K syöte + 20K tuloste | $0.44 | $0.80 | $0.60 |
Suuressa mittakaavassa Gemini 3.1 Pro maksaa noin 45% vähemmän kuin GPT-5.2 ja 27% vähemmän kuin Sonnet 4.6.
Ilmaistaso
- 60 pyyntöä minuutissa, 1M tokenia minuutissa, ei luottokorttia tarvita.
Avainominaisuudet
- 1M tokenin konteksti-ikkuna — GA, sama hinta kuin standardikonteksti
- Mukautetut työkalut — määrittele ulkoisia funktioita joita Gemini voi kutsua
- Grounding Google Searchilla — vähennä hallusinaatioita reaaliaikaisella haulla
- Natiivi multimodaalinen — teksti, kuvat, ääni ja video yhdessä pyynnössä
Koodiesimerkki: Mukautetut työkalut
Python
from google import genai
from google.genai import types
client = genai.Client(api_key="YOUR_API_KEY")
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"),
"unit": types.Schema(type=types.Type.STRING, enum=["celsius", "fahrenheit"]),
},
required=["city"],
),
)
]
)
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]),
)
API-vertailu: Gemini 3.1 Pro vs GPT-5.2 vs Claude Sonnet 4.6
| Ominaisuus | Gemini 3.1 Pro | GPT-5.2 | Claude Sonnet 4.6 |
|---|---|---|---|
| Syötehinta | $2/1M | $5/1M | $3/1M |
| Konteksti | 1M (GA) | 400K | 1M (beta) |
| Multimodaalinen | Teksti + kuva + ääni + video | Teksti + kuva + ääni | Teksti + kuva |
| Koodaus (SWE-bench) | 76.8% | 80.0% | 79.6% |
| Tietokoneen käyttö | N/A | 38.2% | 72.5% |
Integrointi Y Buildin kanssa
// 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));
}
Yhteenveto
Gemini 3.1 Pro on paras hinta-laatu frontier-API maaliskuussa 2026. Kehittäjille neuvomme: käytä Geminiä multimodaalisiin ja kustannusherkkiin tehtäviin, Claudea koodaukseen ja agentteihin, ja GPT-5.2:ta matemaattiseen päättelyyn.
Rakennatko tekoälytuotetta? Y Build käsittelee koko stackin. Aloita ilmaiseksi.
Lähteet:
Be first to build with AI
Y Build is the AI-era operating system for startups. Join the waitlist and get early access.