Gemini Decisions API snelstart: ja/nee-, keuze- en score-antwoorden in Python en curl

De Gemini Decisions API van Google geeft kansen terug in plaats van tekst, zonder gefactureerde output-tokens. Hier is een stapsgewijze snelstart met Python en curl, plus de limieten en valkuilen.

Graphic showing a quickstart for the Gemini Decisions API with a yes, choice and score answer card.

Meestal als je een AI-model iets vraagt, wil je geen opstel terug. Je wilt ‘ja’, ‘billing’ of ‘7 uit 10’, zodat je code een tak kan kiezen en verder kan. De nieuwe Gemini Decisions API van Google is precies daarvoor gemaakt, en output kost niets.

Bekijk het op Mindloop Experience: Gemini Decisions API: 1,000 Questions in One Call for $0.10 per Million Tokens

Deze gids laat zien hoe je je eerste call doet in Python en curl, hoe je de drie soorten antwoorden leest en hoe je de valkuilen vermijdt die Google documenteert. Hij volgt de documentatie van Google zoals die op 15 november 2026 was. We hebben de syntax van de Python- en curl-voorbeelden gecontroleerd (de code compileert en de JSON-body is geldig). Echte calls vragen je eigen API-sleutel, dus de voorbeelduitvoer hieronder komt uit de documentatie.

Wat de Decisions API eigenlijk is

Google lanceerde hem op 11 november 2026 met een model dat Gemini Decision 1 (gemini-decision-1) heet. In plaats van tekst te schrijven, geeft het model een score aan de opties die jij aanlevert en geeft het kansen terug. Volgens Google kan één request tot 1.000 vragen over een gedeelde input bevatten, en ligt de mediane end-to-end-latency op 150 tot 250 milliseconden voor inputs tot 16K tokens.

De prijs is 0,10 dollar per miljoen input-tokens, en de output is altijd nul tokens. Gedeelde input wordt per request maar één keer gefactureerd, hoeveel vragen je ook stelt. Er is een gratis tier in Google AI Studio; volgens de prijspagina van Google kunnen je gegevens daar worden gebruikt om de producten te verbeteren. Bij de betaalde tier staat dat dat niet gebeurt.

Simon Willison merkte op dat het model van Google in een kleine categorie zit met twee concurrenten. Volgens hem kost Gemini Decision 1 hetzelfde als het beslismodel GPT-6 Luna van OpenAI, terwijl een model genaamd Jev goedkoper is met 4,2 cent per miljoen. Hij vond ook een eigenaardigheid: Jev en OpenAI geven bij ja/nee-vragen een vlakke 1.0 of 0.0 terug, terwijl Gemini zachtere getallen gaf, zoals 0.92 en 0.05.

Wat je nodig hebt

  • Een Gemini API-sleutel uit Google AI Studio.
  • Python met de Google GenAI SDK, versie 3.2 of nieuwer. Gebruik je JavaScript, dan heb je @google/genai nodig.
  • Een willekeurige HTTP-client, als je de SDK liever overslaat.

Stap 1: installeer de SDK en stel je sleutel in

Terminal
pip install -U google-genai
export GEMINI_API_KEY=your-key-here

Het curl-voorbeeld in de documentatie van Google leest de sleutel uit GEMINI_API_KEY. Voor een breder overzicht van Gemini aanroepen vanuit Python, JavaScript en curl, zie onze gids voor de Gemini 4 Hydrogen API.

Stap 2: stel je eerste ja/nee-vraag

Dit is de snelstart uit de documentatie van Google. Sla hem op als decisions.py:

Code
from google import genai

client = genai.Client(http_options={"api_version": "v1beta"})

result = client.decisions.create(
    model="gemini-decision-1",
    input="The blue mug I ordered on Monday arrived cracked on Wednesday.",
    questions={
        "is_damaged": {
            "type": "noul",
            "instructions": "Did the item arrive damaged?",
        },
    },
)

answer = result.answers["is_damaged"]
print(f"P(yes)={answer.noul:.2f} confidence={answer.confidence:.2f}")

Voer python decisions.py uit. De documentatie toont een antwoord van 0.99 voor zowel de kans op ja als de confidence, met total_output_tokens op 0. De sleutel die je kiest (is_damaged) is alleen een label. Het model ziet hem nooit, dus zet de hele vraag in instructions.

Stap 3: probeer het met curl

De API is één POST-request, dus je hebt geen SDK nodig:

Terminal
curl -X POST "https://generativelanguage.googleapis.com/v1beta/decisions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-decision-1",
    "input": "The blue mug I ordered on Monday arrived cracked on Wednesday.",
    "questions": {
      "is_damaged": {
        "type": "noul",
        "instructions": "Did the item arrive damaged?"
      }
    }
  }'

Stap 4: leer de drie vraagtypes kennen

TypeGebruik je omcriteria nodig?Wat je terugkrijgt
noulEen ja/nee-bewering te controlerenNeenoul (0.01 tot 0.99), confidence
choiceEén optie uit 2 tot 255 te kiezenJa, een koppeling van optie naar beschrijvingchoice, probabilities, confidence
scoreTe beoordelen op geordende niveaus, vanaf 0Ja, een lijst met niveausscore, probabilities, legend, confidence

Een choice-vraag ziet er zo uit (de voorbeeldinput in de documentatie is ‘I was charged twice for my order.’ [Ik heb twee keer betaald voor mijn bestelling]):

Code
questions={
    "department": {
        "type": "choice",
        "instructions": "Which department should handle this request?",
        "criteria": {
            "billing": "Payments, invoices, and refunds.",
            "technical": "Problems using the product.",
            "shipping": "Delivery and tracking.",
            "other": "Anything outside these categories.",
        },
    },
}

De waarde score is het kansgewogen gemiddelde van de niveaunummers, dus hij kan tussen twee niveaus uitkomen. In de uitleg van Flavio Copes staat 1.12 op een schaal met drie niveaus.

Stap 5: laat confidence bepalen wie actie onderneemt

Elk antwoord bevat een confidence van 0 tot 1: de geschatte kans dat het beste antwoord klopt. Google raadt aan om het antwoord te gebruiken om een actie te kiezen, en de confidence om te bepalen of je code die uitvoert:

Code
answer = result.answers["department"]
if answer.confidence >= 0.7:
    route_to(answer.choice)
else:
    route_to("human_review")

Hier is route_to je eigen functie. Google zegt dat je drempels moet bepalen op basis van gelabelde voorbeelden uit je eigen verkeer, in plaats van 0.7 over te nemen.

Stap 6: bundel je vragen

Zet onafhankelijke vragen over dezelfde input in één request. De gedeelde input telt één keer, en je kunt types mengen. Het voorbeeld van Google routeert een supportticket met een ja/nee-defectcheck, een keuze uit vier acties en een churn-score met vier niveaus in één call. De vragen kunnen elkaar niet zien.

Limieten die je moet kennen

LimietWaarde
Vragen per request1 tot 1.000
Contextvenster262.144 tokens, input plus vragen
Gratis tier200 requests per minuut, 10.000 per dag
Tier 11.500 requests per minuut, 50.000 per dag

Veelvoorkomende fouten en oplossingen

  • Er gebeurt niets als je op zekerheid test. Ja/nee-kansen liggen altijd tussen 0.01 en 0.99, dus een test op noul > 0.99 klopt nooit. Leg je drempels binnen dat bereik.
  • Onzininput krijgt toch een label. Keuzevragen verdelen de kans over je opties, ook als er geen enkele past. Voeg een optie other met beschrijving toe en controleer de confidence.
  • Je restoptie staat niet achteraan. De API sorteert optiesleutels alfabetisch, dus none_of_the_above komt vóór shipping, niet als laatste. Gebruik een beschreven restoptie zoals other.
  • Een 400-fout. Die krijg je als je een limiet overschrijdt, de sleutelvalidatie mislukt of de veiligheidsfilters aanslaan. De foutmelding noemt een code zoals safety.
  • Media laden niet. YouTube-URL’s en gs://-adressen worden niet ondersteund. Gebruik een Files API-URI, een openbare of ondertekende HTTPS-link, of inline base64-data.
  • Je rekening loopt op bij een lang document. Er is geen context caching en geen Batch API, dus herhaalde input telt volledig mee. Stel in plaats daarvan alle vragen in één request.
  • Vreemde resultaten bij tekst van gebruikers. Google waarschuwt dat input kan pleiten voor zijn eigen classificatie. Zet een mens of een tweede controle voor alles waarmee geld gemoeid is.
  • Problemen bij de setup. Controleer of je SDK 3.2 of nieuwer en API-versie v1beta hebt voordat je iets anders gaat debuggen. Volgens de documentatie is de API alleen beschikbaar op v1beta.

Wanneer je iets anders gebruikt

Gebruik de Decisions API voor routering, filtering en regelcontroles met een vaste set antwoorden. Heb je gegenereerde tekst, samenvattingen of waarden volgens je eigen JSON-schema nodig, dan verwijst Google je naar de Interactions API. Draai je modellen liever op je eigen hardware, dan laat onze Ollama-gids zien hoe dat werkt.

Bronnen

Links voor het laatst gecontroleerd op 15 november 2026.

Geschreven door Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

Over Mindloop Experience

Reacties

Schrijf een reactie

Meer van Mindloop Experience

Alles van Mindloop Experience bekijken

Je kunt tot 50 keer klappen.