Home · automatisering

Gemini API tools: loont ophalen?

Gemini API tools pas laden als ze nodig zijn? Bereken tokens en kosten, inclusief extra zoekaanroepen. Een grote context kan je besparing omkeren.

Bereken je toolkosten

Door Redactie 1704media ·

Ontwikkelaars halen enkele instructies uit een grote verzameling gereedschappen
20.000tokens aan schema’s bij 50 × 400, rekenvoorbeeld
v1betade API-versie voor de preview

Vijftig tools met elk 400 tokens aan definities kosten samen 20.000 tokens, nog vóór je vraag. Dat is een rekenvoorbeeld, geen benchmark. Met Gemini API tools kun je die definities voortaan uitstellen. Google kondigde de preview op 19 november aan. Maar de extra zoekaanroep kan de besparing ook opeten.

Googles documentatie noemt de preview en API-versie v1beta
Google Gemini API Documentation, 20 november 2026. De preview kan nog veranderen.

Gemini API tools: alleen laden is niet genoeg

Een schema beschrijft welke invoer een functie verwacht. Tool retrieval houdt zulke details buiten de context totdat ze nodig zijn. Naam en korte beschrijving blijven wel zichtbaar. De preview gebruikt de Interactions API met v1beta; generateContent ondersteunt dit niet.

Voeg {"type":"tool_search"} toe en zet defer_loading: true bij uitgestelde functies. Je eigen code voert de functie daarna nog steeds uit. Google beschrijft dit in de aankondiging en documentatie van 19 november 2026.

tool_searchZoeken aanzetten
defer_loadingSchema later laden
Velden uit Googles previewdocumentatie.

Bereken ook de extra zoekaanroep

Vul je eigen aantallen in. De voorbeeldwaarden zijn aannames. Dit vereenvoudigde model rekent met dezelfde context en gemiddeld geladen schema’s bij elke gewone én extra aanroep. Uitvoer, caching, groeiende gesprekken en verschillen tussen schema’s tellen niet mee.

Toolkosten · rekent alleen in je browser

Het tarief van €1 is een rekenaanname, geen Gemini prijslijst. Vul het tarief van je model in.

Formule en grenzen van deze berekening

Statisch: A × (C + N × S). Ophalen: A × (1 + Q) × (C + N × D + K × S + F). A is gewone aanroepen per dag, C overige context, N alle tools, S volledig schema, D korte beschrijving, K gemiddeld geladen tools, F vaste zoekinstructies en Q extra zoekaanroepen per gewone aanroep. Kosten = tokens ÷ 1.000.000 × jouw tarief.

We tellen de korte beschrijving én het volledige schema van geladen tools mee. Dezelfde gemiddelde set telt ook mee bij de extra zoekaanroepen. Dit is een scenariovergelijking, geen exacte reconstructie van Googles tokenadministratie. Meet daarna total_input_tokens en total_tool_use_tokens in je eigen verkeer.

Een grote context kan ophalen duurder maken

In onze grote voorbeeldstand is statisch laden 2.000 + 50 × 400 = 22.000 tokens per gewone aanroep. Ophalen wordt 2 × (2.000 + 50 × 30 + 2 × 400 + 100) = 8.800 tokens. De factor twee staat voor de gewone aanroep plus één extra zoekaanroep.

Verander alleen de bibliotheek naar 10 tools en de context naar 30.000 tokens. Dan wordt statisch laden 34.000 tokens en ophalen 62.400. De zoekaanroep herhaalt nu vooral gesprekscontext. De grafiek toont deze berekening; dit zijn geen metingen van Google.

50 tools · korte context10 tools · lange contextStatisch 22.000Ophalen 8.800Statisch 34.000Ophalen 62.400
Tokens per gewone aanroep inclusief de veronderstelde extra zoekaanroep. Eigen rekenvoorbeelden, zonder uitvoer en caching.

Laat veelgebruikte functies gewoon geladen

Alles uitstellen is een slechte standaard. Begin met functies die zelden nodig zijn; houd de dagelijkse functies direct beschikbaar. Google adviseert dat ook. Ophalen heeft geen afzonderlijke toeslag, maar de gebruikte tokens worden wel afgerekend. Geladen schema’s blijven bovendien in het gesprek.

Ook dit rekenmodel heeft een zwakke plek: het gebruikt gemiddelden. Een lange conversatie kan steeds meer schema’s verzamelen. Een lage tokenuitkomst bewijst evenmin dat de juiste functie wordt gekozen. Controleer daarom verkeerde toolkeuzes en responstijd naast kosten.

Diezelfde scheiding tussen techniek en echte werking speelt bij onze uitleg over van AI chat naar teamworkflow. Voor een contentproces zijn daarnaast creatieve content schrijven met AI en WP SEO AI andere taken dan het kiezen van een functie.

Vaak gebruikt

Direct laden

Zelden gebruikt

Uitstellen en meten

Minder tokens is één uitkomst; de juiste functie blijft nodig.

Welke functies stel je bij je volgende koppeling uit?

  1. Noteer welke functies je agent werkelijk gebruikt en welke alleen beschikbaar moeten blijven.
  2. Vul de calculator met aantallen uit die koppeling. Test ook een lang gesprek en een extra zoekaanroep.
  3. Vergelijk daarna dezelfde taken met en zonder ophalen. Leg tokens, responstijd en verkeerde toolkeuzes vast.

Voor Media en Internet telt zo’n werkende koppeling meer dan een lange lijst beschikbare functies. Onze projecten laten zien in welke producten zulke keuzes terechtkomen. Bij een volgende previewwijziging kijken we of geladen schema’s en zoekkosten anders worden behandeld.

Bronnen: Google, “Introducing Tool Retrieval in the Gemini API”, 19 november 2026; Google Gemini API Documentation, “Tool retrieval”, geraadpleegd 20 november 2026. Aanleiding: Unite.AI, 19 november 2026.

Je context kan de besparing omkeren

Vergelijk de korte en lange voorbeeldcontext met je eigen aantallen.

Bereken je toolkosten