Hoe de Gemini 3.1 pro API gebruiken

CometAPI
AnnaFeb 21, 2026
Hoe de Gemini 3.1 pro API gebruiken

Een praktische, codegerichte gids voor Gemini 3.1 Pro — wat het is, hoe je het aanroept (ook via CometAPI), de multimodale en ‘thinking level’-regelaars, functieaanroepen/toolgebruik, vibe-codingtips, en integraties met GitHub Copilot, VS Code, de Gemini CLI en Google Antigravity. Gemini 3.1 pro verlegt de grens van grote multimodale modellen met een ontwikkelaarsgerichte focus: grotere contextvensters, configureerbare ‘thinking’-modi, verbeterde tool- en functieaanroepen en expliciete ondersteuning voor agent‑gebaseerde workflows.

Wat is Gemini 3.1 Pro?

Gemini 3.1 Pro is de nieuwste ‘Pro’-laag in de Gemini 3‑familie: een native multimodaal, reasoning‑first model, afgestemd op complexe, meerstappige taken en agentisch toolgebruik. Het wordt gepresenteerd als een verfijning van Gemini 3 Pro met drie praktische focussen: sterkere redenering/feitelijke verankering, betere tokenefficiëntie en controleerbare uitvoeringsmodi gericht op ontwikkelaarsworkflows (code, planning, retrieval‑augmented taken). De modelkaart en ontwikkelaars‑pagina’s beschrijven het als geoptimaliseerd voor software‑engineeringgedrag, agentische pipelines en multimodale input (tekst, afbeeldingen, audio, video en repositories).

Waarom dat voor jou belangrijk is: de combinatie van een contextvenster van een miljoen tokens (op veel providervarianten), expliciete function‑calling‑primitieven en ‘thinking level’-regelaars geeft teams voorspelbare kosten en outputs voor alles — van snelle prototyping tot productie‑agentorkestratie. CometAPI brengt 3.1 Pro al naar voren via API‑marktplaatsen en OpenAI‑compatibele bridges, met pay‑as‑you‑go‑toegangspatronen.

Hoe kun je de Gemini 3.1 Pro API gebruiken (CometAPI)?

Wat heb ik nodig voordat ik begin?

Checklist (vereisten)

  • Een CometAPI‑account en een CometAPI API‑sleutel (sla deze op in omgevingsvariabelen).
  • Optioneel een Google Cloud / Google AI Studio‑project & Gemini API‑sleutel als je ooit rechtstreeks via Google aanroept (niet vereist via Comet).
  • python 3.9+ of node 18+, curl beschikbaar voor snelle tests.
  • Een veilige geheimen‑mechanisme: omgevingsvariabelen, vault of CI‑geheimenopslag.
  • Bevestig de Comet‑model‑id voor Gemini 3.1 Pro in je Comet‑console (bijv. "google/gemini-3.1-pro" of een Comet‑specifieke alias).

CometAPI ondersteunt oproepen in het native Gemini‑formaat, evenals het chatformaat van OpenAI. CometAPI vereenvoudigt het wisselen tussen modellen, biedt één basis‑URL en SDK’s, en kan integratiewrijving voor multi‑vendor stacks verminderen.

Hieronder staan twee concrete, copy‑paste‑vriendelijke voorbeelden: eerst Gemini aanroepen via CometAPI (OpenAI‑compatibele client), en vervolgens Gemini aanroepen via Google’s officiële Gemini HTTP‑endpoint. Vervang YOUR_API_KEY door je provider‑sleutel en stel modelnamen in op de bij de provider beschikbare variant (bijv. gemini-3.1-pro-preview waar beschikbaar).

Voorbeeld: Gemini 3.1 Pro aanroepen met CometAPI (curl + Python)

Curl (OpenAI‑compatibele wrapper met CometAPI‑basis‑URL)

# curl example: CometAPI (OpenAI-compatible)curl https://api.cometapi.com/v1/chat/completions \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "gemini-3.1-pro-preview",    "messages": [      {"role":"system","content":"You are a concise programming assistant."},      {"role":"user","content":"Write a Python function to fetch CSV from a URL and return pandas DataFrame."}    ],    "max_tokens": 800  }'

Python (OpenAI‑compatibele client geconfigureerd op CometAPI base_url)

from openai import OpenAI  # or openai-python-compatible SDK offered by your platformclient = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.cometapi.com/v1")resp = client.chat.completions.create(    model="gemini-3.1-pro-preview",    messages=[        {"role": "system", "content": "You are a concise programming assistant."},        {"role": "user", "content": "Write a Python function to fetch CSV from a URL and return pandas DataFrame."}    ],    max_tokens=800,)print(resp.choices[0].message.content)

Reden: CometAPI biedt in veel van hun documentatie een OpenAI‑compatibele bridge, waarmee je bestaande OpenAI‑clientcode kunt hergebruiken door simpelweg de base_url en modelnaam te wijzigen. Dit is handig voor multi‑provider‑experimenten en snelle prototyping.

Voorbeeld: Gemini aanroepen via de officiële Gemini API (Node.js / HTTP)

De officiële Gemini‑endpoints van Google zijn het beste voor de volledige set features (thinking‑level‑regelaars, function calling, multimodale uploads). Hieronder staat een minimale HTTP‑voorbeeldaanroep met de Gemini API‑oppervlakte zoals beschreven in de Google AI‑ontwikkelaarsdocs.

Vervang eenvoudig de Base URL en API‑sleutel in de officiële SDK of requests om deze te gebruiken:

  • Basis‑URL: https://api.cometapi.com (vervang generativelanguage.googleapis.com)
  • API‑sleutel: Vervang $GEMINI_API_KEY door je $COMETAPI_KEY

Curl (officiële Gemini API — illustratief)

curl "https://api.cometapi.com/v1beta/models/gemini-3-1-pro-preview:generateContent" \
  -H "x-goog-api-key: $COMETAPI_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "How does AI work?"
          }
        ]
      }
    ]
  }'

Veelvoorkomende parameters die je instelt

  • temperature (0.0–1.0) — willekeur. Gebruik 0.0 voor deterministische code‑outputs.
  • max_output_tokens / max_tokens — budget voor outputlengte.
  • top_p — nucleus sampling.
  • presence_penalty / frequency_penalty — herhaling ontmoedigen.
  • thinking_level of modelvariant — bepaalt de redeneringsdiepte (bijv. -low, -medium, -high of expliciet thinking_level). Gebruik het laagste denkniveau dat aan de nauwkeurigheidsbehoeften voldoet om kosten/latentie te beheersen.

Wat zijn de multimodale mogelijkheden van Gemini 3.1 Pro?

Welke modaliteiten ondersteunt Gemini 3.1 Pro?

Gemini 3.1 Pro accepteert tekst, afbeeldingen, video, audio en PDF’s in veel preview‑builds — en kan tekstoutputs synthetiseren die verwijzen naar of multimodale content samenvatten. Comet ondersteunt het doorsturen van multimodale input naar Gemini — via afbeeldings‑URL, bestandupload (Comet file API), of door Gemini bestanden te laten lezen die in cloudopslag staan.

Hoe moeten ontwikkelaars denken over multimodale prompts?

  • Structureer multimodale prompts met duidelijke contextblokken: zet bijvoorbeeld de korte tekstinstructie eerst, voeg daarna metadata of verwijzingen toe voor afbeeldingen/video’s/PDF’s.
  • Gebruik de media‑bijlagen en uploadvelden van de SDK in plaats van binaire data in tekstvelden in te bedden — de officiële clients en de Vertex AI / Gemini API‑voorbeelden laten zien hoe je media‑bijlagen netjes doorgeeft.

Praktisch voorbeeld (pseudocode): toon een afbeelding plus een vraag

# Pseudocode — attach an image with a caption and ask a questionfrom google.gemini import GemSDK  # conceptual import; use official client per docsresponse = client.generate(    model="gemini-3.1-pro-preview",    inputs = [        {"type": "text", "content": "Summarize the visual diagram and list actionable next steps."},        {"type": "image", "uri": "gs://my-bucket/diagram.png", "alt": "system architecture diagram"}    ])print(response.text)

Praktische tips:

  • Gebruik afbeeldingsbijlagen voor UI‑bugtriage: voeg een screenshot toe en vraag om diffs of waarschijnlijke oorzaken.
  • Combineer audio‑transcripties met codevoorbeelden voor samenvattingen van interviewopnamen.
  • Bij het versturen van grote artefacten (video’s, grote codebases), kies je beter een gefaseerde aanpak: upload assets (cloudopslag), geef URL’s + korte manifest, en gebruik het model om een retrieval‑augmented pipeline aan te sturen in plaats van alles in één prompt te stoppen.

Wat zijn de denkniveaus (Low, Medium, High) en wanneer moet ik ze gebruiken?

Wat zijn ‘denkniveaus’?

De Gemini 3‑serie introduceert een thinking_level‑parameter die het interne compute/denkbudget van het model aanstuurt. Zie het als een knop die latentie + kosten inruilt voor grotere redeneer‑diepte:

  • Low: minimale redenering, geoptimaliseerd voor throughput en korte, deterministische taken.
  • Medium: gebalanceerde redenering — nieuw in 3.1 en ideaal voor veel engineering‑ en analytische workflows.
  • High: diepere redenering, dynamische chain‑of‑thought‑stijl; het beste voor complexe meerstapsproblemen.
    (Er is ook een minimal/max‑nomenclatuur in andere varianten — raadpleeg de modeldocs voor de exacte beschikbare opties per variant.)

Hoe kies ik een denkniveau?

  • Gebruik Low voor high‑throughput gebruikerschat, korte instructies of wanneer kosten/latentie cruciaal zijn.
  • Gebruik Medium als standaard voor de meeste ontwikkelaarstaken die een gematigde mate van redenering nodig hebben (dit is de nieuwe ‘sweet spot’ in 3.1).
  • Gebruik High bij het oplossen van puzzels, lange logische ketens, planning, of wanneer je expliciet hoge nauwkeurigheid wilt en hogere latentie en tokenverbruik accepteert.

Het denkniveau instellen in een request

curl "https://api.cometapi.com/v1beta/models/gemini-3-1-pro-preview:generateContent" \
  -H "x-goog-api-key: $COMETAPI_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [{ "parts": [{ "text": "Explain quantum physics simply." }] }],
    "generationConfig": {
      "thinkingConfig": {
        "thinkingLevel": "LOW"
      }
    }
  }'

Hoe implementeer ik functieaanroepen en toolgebruik met Gemini 3.1 Pro?

Wat is functieaanroepen/toolgebruik?

Function calling (ook wel toolgebruik) laat het model gestructureerde ‘call’-objecten uitsturen die je applicatie vertellen welke externe tool of functie moet worden uitgevoerd (bijvoorbeeld get_current_weather(location)) en met welke argumenten. Het model kan meerdere aanroepen ketenen, tooloutputs ontvangen en verder redeneren — wat agentisch gedrag mogelijk maakt. Gemini SDK’s bieden ingebouwde ondersteuning voor de model‑naar‑tool‑lus (MCP/toolregistry) zodat je uitvoering veilig kunt automatiseren.

Je kunt tools declareren in de configuratie om proxy‑gedrag in te schakelen. Ondersteunde ingebouwde tools omvatten de google_search, code_execution en url_context‑customfuncties.

Veilig patroon voor toolgebruik

  1. Definieer toolinterfaces: registreer functies/tools met duidelijke schema’s en gevalideerde argumenttypes.
  2. Laat het model aanroepen voorstellen: het model geeft gestructureerde JSON uit die beschrijft welke tool moet worden aangeroepen.
  3. De host voert alleen tools op de allowlist uit: handhaaf een allowlist en strikte validatie.
  4. Geef tooloutputs terug aan het model: de SDK‑lus voert de toolrespons terug naar het model zodat het kan blijven plannen/meer aanroepen kan uitvoeren.

Integratiegids voor Gemini 3.1 Pro

GitHub Copilot

GitHub Copilot (Copilot) heeft inmiddels ondersteuning toegevoegd voor Gemini‑familie‑modellen op premium‑tiers, waardoor teams Gemini kunnen kiezen als onderliggend model voor Copilot‑chat en suggesties. Dat betekent dat gebruikers op in aanmerking komende plannen Gemini‑varianten kunnen selecteren in de Copilot‑modelkiezer en profiteren van modelverbeteringen zonder hun IDE‑extensie te wijzigen. Voor teams blijft Copilot een handige beheerde route naar Gemini‑redenering binnen VS Code en andere ondersteunde editors.

Gemini CLI en Code Assist

De open‑source Gemini CLI stelt Gemini‑modellen bloot via de terminal; hij is lichtgewicht en integreert met bestaande workflows (diffs, commits, CI en headless serverruns). Gebruik de CLI voor snelle iteratie, het scripten van agentruns of het inbedden van het model in DevOps‑flows. Gemini Code Assist is de VS Code‑extensie en bredere IDE‑integratie die contextbewuste codesuggesties, PR‑reviews en geautomatiseerde fixes rechtstreeks in de editor brengt. Deze tools laten je de modelselectie, contextvensters en denkniveauvoorkeuren beheren.

Visual Studio Code

Visual Studio Code en zijn marketplace hosten zowel GitHub Copilot als Gemini Code Assist. Je kunt Code Assist voor Gemini installeren of Copilot blijven gebruiken; elk biedt verschillende afwegingen (snelheid, diepte, privacy). VS Code blijft het meest volwassen oppervlak voor interactieve codegeneratie, in‑editor chat en directe integratie met lokale runs of testharnassen.

Google Antigravity

Google Antigravity is een agent‑first IDE en platform dat agents als first‑class burgers behandelt, met een ‘Mission Control’ voor agentorkestratie, ingebouwde browserautomatisering en een UI voor multi‑agentprojecten. Antigravity en Gemini CLI dienen verschillende behoeften: Antigravity is een volledig agentisch IDE‑oppervlak; Gemini CLI is terminal‑native maar integreert in Antigravity en VS Code via extensies en MCP (Model Context Protocol)‑servers. Het Antigravity‑ecosysteem is gepositioneerd voor teams die zware agentorkestratie willen en een meer uitgesproken, visueel oppervlak.

Wie moet wat gebruiken?

  • Snelle prototyping & single‑file‑edits: Gemini CLI + lokale tests of Copilot voor snelheid.
  • Diepe redenering, langlopende research: Gemini API (Vertex) met hoog denkniveau en function calling.
  • Agentische orkestratie & meerstapsautomatisering: Antigravity voor visueel beheer of een aangepaste agent‑pipeline met function calling + MCP.
  • Multi‑provider‑experimenten / kostenbeheersing: Gebruik CometAPI of vergelijkbare aggregators om modellen te wisselen of Flash vs Pro economisch te proberen.

Ontwerpoverwegingen voor integratie:

  • Security: vermijd het versturen van secrets of PII in prompts. Gebruik token‑gescope serviceaccounts voor server‑side aanroepen.
  • Lokaal vs cloud: voer lichtgewicht assistentfeatures lokaal uit (snelle completions) maar routeer zware multimodale analyse naar de cloud.
  • Gebruikerscontrole: bied ‘leg deze suggestie uit’ en eenvoudige rollback‑bediening voor code‑edits die door het model zijn geproduceerd.

Integratiepatronen & aanbevolen architectuur

Lichtgewicht app (chat of assistent)

  • Client (browser/mobile) → backend‑microservice → Gemini API (thinking_level=low)
  • Gebruik streaming/partiële outputs voor chat‑UX. Valideer gebruikersinput en sta nooit raw toolcalls toe vanaf niet‑vertrouwde clients.

Agentische backend (geautomatiseerde workflows)

  • Orchestrator‑service: registreer een kleine set geallowliste tools (DB‑read, CI‑jobrunner, interne API’s).
  • Laat Gemini plannen en toolcalls uitsturen; de orchestrator voert gevalideerde aanroepen uit en geeft resultaten terug. Gebruik hoog denkniveau voor planningsfases en medium voor uitvoeringsstappen.

Multimodale ingest‑pipeline

Preprocess en indexeer grote documenten, afbeeldingen of video’s.

Wanneer moet je Gemini 3.1 Pro kiezen?

Kies Gemini 3.1 Pro wanneer je:

  • hoge‑fideliteit, meerstaps‑redenering over multimodale input nodig hebt;
  • betrouwbare toolorkestratie en agentische workflows wilt;
  • betere code‑synthese/edit‑loops in IDE’s (via Copilot/CLI/Antigravity) zoekt; of
  • cross‑provider‑vergelijkingen wilt prototypen met een gateway zoals CometAPI.

Als je geeft om throughput en kosten, hanteer een gemengde strategie: standaard medium denkniveau voor de meeste workflows, low voor high‑throughput gebruikerschat, en high alleen voor taken die aantoonbaar diepere redenering nodig hebben (planning, bewijzen, meerstapsynthese).

Slotgedachten: waar Gemini 3.1 Pro past in de stack

Gemini 3.1 Pro zet in op wat moderne, op ontwikkelaars gerichte LLM’s moeten bieden: multimodale begrip, expliciete toolorkestratie en pragmatische regelaars voor het redeneringsbudget. Of je er nu direct toegang toe krijgt via Google’s API’s en Vertex, via Copilot op premium‑plannen, of via multi‑modelplatformen zoals CometAPI, de kritische vaardigheden voor teams blijven hetzelfde: zorgvuldige denkniveau‑orkestratie, veilige function‑calling‑patronen, en integratie in solide ontwikkelaarsworkflows (CLI, IDE, geautomatiseerde tests).

Ontwikkelaars kunnen Gemini 3.1 Pro nu openen via CometAPI. Begin met het verkennen van de mogelijkheden van het model in de Playground en raadpleeg de API‑gids voor gedetailleerde instructies.  Zorg ervoor dat je bent ingelogd bij CometAPI en de API‑sleutel hebt verkregen voordat je toegang krijgt. CometAPI biedt een prijs die veel lager ligt dan de officiële prijs om je integratie te helpen.

Ready to Go?→ Sign up fo Gemini 3.1 pro today !

Als je meer tips, gidsen en nieuws over AI wilt weten, volg ons op VK, X en Discord!

Toegang tot topmodellen tegen lage kosten

Lees Meer