Skip to content
DecisionNodeDecisionNdedocs
  • Guides
  • API reference
  • Examples
  • Playground

start here

  • QuickstartGet startedGet an API key, send one request with three questions, and branch your code on the typed answers. Plain HTTPS, no SDK to install.
  • POST /v1/decideAPI referenceAnswer typed questions about a state and optional images. One request, one buffered JSON response, one answer per question.
  • QuestionsConceptsQuestions say what to decide. Each one has a type that fixes the shape of its answer: a choice from your options, a score on your scale, a…
  • ConfidenceConceptsProbabilities are calibrated per question type, so a threshold means what it says.
  • ImagesConceptsSend images and text in the same request. The model reads printed and handwritten text, amounts, dates, objects and layout, and answers…
  • Pricing and billingYou pay for input tokens only. Output is free because the model generates no text.
↑↓ moveopen6 suggestions
Get API keyGet API key
DecisionNodeDecisionNde

Get started

  • Introduction
  • Quickstart
  • With coding agents
  • Examples

Concepts

  • State
  • Questions
  • Choice
  • Score
  • Truth
  • Number
  • Images
  • Confidence
  • Determinism

Models

  • DecisionNode-1.0
  • DecisionNode-1.0 Flash
  • Limits

Patterns

  • Confidence-gated routing
  • Fan-out
  • Guardrails
  • Control loopscomingcoming soon

API reference

  • POST/v1/decide
  • POST/v1/sessionscomingcoming soon
  • GET/v1/models
  • Errors
  • Rate limits

Pricing and billing

  • Pricing and billing

Policies

  • Responsible use

Migrate

  • Coming from a Jev-shaped API
  • Benchmarks
  • Pricing
  • Playground
Get API key
  • Guides
  • API reference
  • Examples
  • Playground

Get started

  • Introduction
  • Quickstart
  • With coding agents
  • Examples

Concepts

  • State
  • Questions
  • Choice
  • Score
  • Truth
  • Number
  • Images
  • Confidence
  • Determinism

Models

  • DecisionNode-1.0
  • DecisionNode-1.0 Flash
  • Limits

Patterns

  • Confidence-gated routing
  • Fan-out
  • Guardrails
  • Control loopscomingcoming soon

API reference

  • POST/v1/decide
  • POST/v1/sessionscomingcoming soon
  • GET/v1/models
  • Errors
  • Rate limits

Pricing and billing

  • Pricing and billing

Policies

  • Responsible use

Migrate

  • Coming from a Jev-shaped API
  1. docs
  2. /
  3. Concepts

Confidence

Probabilities are calibrated per question type, so a threshold means what it says. This page explains what calibrated means and how to choose where to draw the line.

on this page3 sections
  1. What calibrated means
  2. Where confidence lives in each type
  3. Choice confidence
  4. Score confidence
  5. Choosing a threshold

What calibrated means#

Take every Truth answer the model gave near 0.9. If about nine in ten of those statements are actually true, the probabilities are calibrated. That is what makes a threshold meaningful: at 0.9 you accept about one wrong answer in ten among the ones that pass, and you can reason about that before you ship.

Where confidence lives in each type#

  • Choice

    Field to gate on
    confidence
    Range and meaning
    0 when all options are equally likely, 1 when one option has all the probability
  • Score

    Field to gate on
    confidence, or a sum of probabilities
    Range and meaning
    How tightly the levels sit around the most likely one; tail sums answer "at least level n"
  • Truth

    Field to gate on
    truth
    Range and meaning
    The probability that the statement is true; distance from 0.50 is how sure it is
  • Number

    Field to gate on
    confidence, or a sum of probabilities
    Range and meaning
    The probability of number; add its neighbours for the chance the true value is within one
Confidence by question type
TypeField to gate onRange and meaning
Choiceconfidence0 when all options are equally likely, 1 when one option has all the probability
Scoreconfidence, or a sum of probabilitiesHow tightly the levels sit around the most likely one; tail sums answer "at least level n"
TruthtruthThe probability that the statement is true; distance from 0.50 is how sure it is
Numberconfidence, or a sum of probabilitiesThe probability of number; add its neighbours for the chance the true value is within one

Choice confidence#

confidence = (K · p_max − 1) / (K − 1)

K
the number of options
p_max
the probability of the chosen option

Score confidence#

confidence = 1 − E[|i − m|] / D(K)

D(K) = floor(K · K / 4) / K

K
the number of levels
m
the most likely level, the lowest one on a tie
E[|i − m|]
the expected distance from m: sum(p_i · |i − m|)

Both are computed from the unrounded probabilities, then rounded to 2 decimals. A score's confidence is 1 when all the probability sits on one level, and probability next to the most likely level costs little. With two levels the two formulas agree. The Score page works one through.

Choosing a threshold#

  1. 1.Start at 0.7 for choice and number confidence and 0.8 for Truth gates.
  2. 2.Run a few hundred real inputs whose outcome you already know, such as resolved tickets or settled disputes.
  3. 3.For each threshold, measure two numbers: how many inputs pass, and how many of those are wrong.
  4. 4.Pick the threshold where the error rate is one your product can live with. Above it your code acts instantly; below it, it takes the safe action or re-checks with the full model.
  5. 5.Re-check after you change the questions or move to a new model version.

Thresholds belong to a question and a model

Changing the instructions, the options or the model version changes the distribution. Keep thresholds in config next to the question they belong to, and pin the model version in production.

previousImagesnextDeterminism

DecisionNode is built and run by Bynn Intelligence, Inc.

  • Home
  • Playground
  • Examples
  • Console
  • Responsible use
  • Terms
  • Acceptable use
  • Privacy
  • Data processing
  • Defence addendum
  • Cookies

on this page

  1. What calibrated means
  2. Where confidence lives in each type
  3. Choice confidence
  4. Score confidence
  5. Choosing a threshold