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

Determinism

The same request to the same model version returns the same answer. There is no sampling and no temperature, so answers can be tested, cached and audited.

on this page4 sections
  1. Same request, same answer
  2. Pin the version
  3. What changes an answer
  4. What you can build on it

Same request, same answer#

The model reads the request in one pass and returns the answer directly; nothing is sampled, so there is no temperature or seed to set. Send a request twice and you get the same probabilities to the last digit.

Pin the version#

decisionnode-latest moves to new versions as we release them. The model field in every response says which version answered. Where answers must not change, send the pinned id instead.

  • decisionnode-latest

    Answers from
    the newest version, today decisionnode-1.0
    Use when
    you want improvements as they ship
  • decisionnode-1.0

    Answers from
    exactly that version
    Use when
    answers must stay identical: tests, audits, tuned thresholds
Model ids
SendAnswers fromUse when
decisionnode-latestthe newest version, today decisionnode-1.0you want improvements as they ship
decisionnode-1.0exactly that versionanswers must stay identical: tests, audits, tuned thresholds

What changes an answer#

  • Any change to the state, images, instructions or criteria, even whitespace.
  • The order of options in criteria for a score (it defines the levels), and the option keys and descriptions for a choice.
  • A different model version.

What you can build on it#

  • Snapshot tests: post a fixed request in CI and assert the answer, the way you would test a pure function.
  • Caching: hash the request body and cache the response. A hit is exactly what the API would have returned.
  • Audit trails: store the request and the x-request-id; replaying the request on the pinned version reproduces the decision.
previousConfidencenextDecisionNode-1.0

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. Same request, same answer
  2. Pin the version
  3. What changes an answer
  4. What you can build on it