Playbooks · Coding tasks
Gemini Decision: a model and API for choices
Written November 12, 2026
Google's new Decision model and Decisions API are in AI Studio. What the docs say it does, what it costs, and where the limits sit.
What it is
One naming point first, because two products share it: OpenAI has a Decisions API too, covered on the Luna page linked below. This page is Google's. The Gemini API changelog for November 11, 2026 releases Gemini Decision 1 (gemini-decision-1) and the Decisions API for fast, calibrated binary, categorical, and rubric decisions across text, images, audio, video, and PDFs, with zero output tokens.
The Decisions API guide frames the job plainly: when code needs a judgment to branch on, generating prose and parsing it adds latency and brittle parsing logic. A call sends one shared input and a map of questions, and returns one typed answer per question. The model scores the options in a single forward pass instead of writing answer text token by token, and every answer carries calibrated probabilities your code can branch, sort, and route on directly. Google's named uses are tool selection, policy checks, model routing, and context grading.
The three question types
- Yes/no (
noul). Checks whether a statement holds. Returns a probability from 0.01 to 0.99 that the answer is yes, plus a confidence score. Optional criteria can define what yes and no mean. - Choice (
choice). Picks one option from a fixed list of 2 to 255. Returns the winning option, a probability for every option, and a confidence score. - Score (
score). Rates the input against ordered rubric levels, 2 to 255 of them, with 2 to 10 recommended for most rubrics. Returns a probability-weighted score, per-level probabilities, a legend, and a confidence score.
Questions are independent: each one runs against the shared input on its own, questions cannot see each other, and adding or removing one does not change the others. The guide's advice is to keep each question narrow and single-purpose, write the full question in its instructions, and combine the answers with ordinary code. The confidence score is the routing signal: it tells your code whether to act on an answer or send the case to a fallback or a person.
Price and speed
The pricing page lists Gemini Decision 1 at $0.10 per million input tokens on the paid tier, free of charge on the free tier, with no output price because the model generates zero output tokens. The shared input is billed once per request no matter how many questions you ask; each question adds only its own instruction and criteria tokens. Google's launch post reports 150 to 250 milliseconds of end-to-end latency, with median model compute of 50 to 100 milliseconds across inputs up to 16K tokens, staying nearly flat from 1 to 100 questions per request. Those speed figures are Google's, stated as Google's.
Limits
- One request holds 1 to 1,000 questions, bounded by a 262,144-token context window shared by the input and all questions. Question instructions are text only, even though the shared input can be text, images, audio, video, or a PDF.
- The API lives on the Gemini Developer API (
v1beta) with Gemini Decision 1 only. It does not support context caching, the Batch API, or Flex or Priority inference, so repeated input across requests is billed in full every time. - It returns no prose, no explanation, and no extracted fields. A job that needs generated text, a summary, or values in your own JSON schema belongs on a generative endpoint; this one answers closed questions only.
- YouTube URLs and direct Cloud Storage URIs are not accepted as input, and conversation history or tool-call blocks cannot be sent as input blocks. Multi-turn context has to be flattened into text first.
Related playbooks
- Gemini API now takes Office files and returns files
- Gemini Embedding 2: update your model string
- Run Muse Spark in another harness via the Model API
- Gemini Computer Use is generally available
Sources
- Release notes — Gemini API, Google AI Studio
- Decisions API — Gemini API, Google AI Studio
- Gemini Developer API pricing — Google AI Studio
- Gemini Decisions API: Fast multimodal decisions — Google Blog
Back to: Coding playbooks hub · Also: OpenAI Decisions API: Luna answers yes or no · Gemini 4 Carbon is here: $2 in, $10 out