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, nothing to install.
  • POST /v1/decideAPI referenceAnswer typed questions about a state, optional images and video frames. 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 on the data we measure.
  • ImagesConceptsSend up to 16 images and text in the same request. The model reads printed and handwritten text, amounts, dates, objects and layout, and…
  • Batch jobsPatternsSend up to 10,000 requests in one file and collect the answers later, at a lower price than live calls.
  • Pricing and billingEvery workspace runs on a plan: Starter, Pro, Business or Dedicated.
↑↓ moveopen7 suggestions
Get API keyGet API key
DecisionNodeDecisionNde

Get started

  • Introduction
  • Quickstart
  • CLI
  • Playground
  • Console and keys
  • With coding agents
  • MCP server
  • Examples

Concepts

  • State
  • Questions
  • Choice
  • Score
  • Truth
  • Number
  • Points and boxes
  • Images
  • Video
  • Boosters
  • Collections
  • Confidence
  • Determinism
  • API keys

Knowledge

  • Overview
  • Documents
  • In a decision
  • Pricing and your data
  • When a rule does not appear

Models

  • DecisionNode
  • DecisionNode Flash
  • DecisionNode Edge
  • Limits
  • Versions
  • Dedicated capacity

Fine-tuning

  • Overview
  • Prepare your dataset
  • Upload and validation
  • Start a training run
  • Watch a run
  • The quality gate
  • Use your model
  • Limits and pricing

Patterns

  • Confidence-gated routing
  • Form router
  • Fan-out
  • Guardrails
  • Control loops
  • Batch jobs
  • Keys on devices
  • Bill your customers per device
  • Publishable keys

Integrations

  • Home Assistant
  • MQTT bridge
  • ROS 2

API reference

  • Overview
  • POST/v1/decide
  • POST/v1/systemone
  • GET/v1/models
  • POST/v1/uploads
  • /v1/keys
  • GET/v1/keys/{key_id}/usage
  • GET/v1/usage
  • POST/v1/credit
  • Errors
  • Safety check
  • Rate limits

Sessions API

  • Sessions overview
  • POSTOpen a session
  • WSStream frames
  • DELEnd a session

Collections API

  • Overview
  • POSTCreate a collection
  • GETList collections
  • GETRetrieve a collection
  • DELDelete a collection
  • POSTEnroll a face
  • GETList items
  • PATCHUpdate an item
  • DELDelete an item
  • POSTAdd a document
  • PUTReplace a document
  • GETRetrieve an item
  • GETList passages
  • DELDelete failed documents
  • POSTSearch a knowledge base

Batch API

  • The batch object
  • POSTCreate a batch
  • POSTAdd requests
  • POSTFinalize a batch
  • GETRetrieve a batch
  • GETGet batch results
  • POSTCancel a batch
  • GETList batches

Pricing and billing

  • Pricing and billing
  • Refer & earn

Policies

  • Responsible use
  • Data and privacy
  • Benchmarks
  • Pricing
  • Playground
Get API key
  • Guides
  • API reference
  • Examples
  • Playground

Get started

  • Introduction
  • Quickstart
  • CLI
  • Playground
  • Console and keys
  • With coding agents
  • MCP server
  • Examples

Concepts

  • State
  • Questions
  • Choice
  • Score
  • Truth
  • Number
  • Points and boxes
  • Images
  • Video
  • Boosters
  • Collections
  • Confidence
  • Determinism
  • API keys

Knowledge

  • Overview
  • Documents
  • In a decision
  • Pricing and your data
  • When a rule does not appear

Models

  • DecisionNode
  • DecisionNode Flash
  • DecisionNode Edge
  • Limits
  • Versions
  • Dedicated capacity

Fine-tuning

  • Overview
  • Prepare your dataset
  • Upload and validation
  • Start a training run
  • Watch a run
  • The quality gate
  • Use your model
  • Limits and pricing

Patterns

  • Confidence-gated routing
  • Form router
  • Fan-out
  • Guardrails
  • Control loops
  • Batch jobs
  • Keys on devices
  • Bill your customers per device
  • Publishable keys

Integrations

  • Home Assistant
  • MQTT bridge
  • ROS 2

API reference

  • Overview
  • POST/v1/decide
  • POST/v1/systemone
  • GET/v1/models
  • POST/v1/uploads
  • /v1/keys
  • GET/v1/keys/{key_id}/usage
  • GET/v1/usage
  • POST/v1/credit
  • Errors
  • Safety check
  • Rate limits

Sessions API

  • Sessions overview
  • POSTOpen a session
  • WSStream frames
  • DELEnd a session

Collections API

  • Overview
  • POSTCreate a collection
  • GETList collections
  • GETRetrieve a collection
  • DELDelete a collection
  • POSTEnroll a face
  • GETList items
  • PATCHUpdate an item
  • DELDelete an item
  • POSTAdd a document
  • PUTReplace a document
  • GETRetrieve an item
  • GETList passages
  • DELDelete failed documents
  • POSTSearch a knowledge base

Batch API

  • The batch object
  • POSTCreate a batch
  • POSTAdd requests
  • POSTFinalize a batch
  • GETRetrieve a batch
  • GETGet batch results
  • POSTCancel a batch
  • GETList batches

Pricing and billing

  • Pricing and billing
  • Refer & earn

Policies

  • Responsible use
  • Data and privacy
  1. docs
  2. /
  3. Models

DecisionNode

Our most accurate decision model, trained by us and served on our own GPUs. $0.042 per million input tokens, output free.

on this page4 sections
  1. When to use it
  2. How it answers
  3. Calling it
  4. When it has no ready capacity
model id
decisionnode (today decisionnode-main-0.9.1-rc1)
Answers
Choice, Score, Truth, Number, Point and Box, each calibrated
Serves
/v1/decide, sessions and batch jobs
Input
Text, JSON, up to 16 images and video as frames in one request
Context
64k tokens per request (65,536)
Price
$0.042 per 1M input tokens, output free
Images and video
$0.09 per 1M image and video tokens, no fee per image
Batch jobs
30% off: $0.0294 per 1M input tokens
Runs on
Our own inference stack and our own GPUs
No ready capacity
Answered at once by DecisionNode Flash, unless you opt out: see below

When to use it#

Use the full model when the decision is subtle: long threads, many options, images with small print, rubrics where the levels are close together. It is the default in these docs and in the playground.

Both models are System One models: one pass, no deliberation, a calibrated probability over the options you allowed (what that means). Pick between them on accuracy, speed and price, not on what they can do; they answer the same question types.

How it answers#

It reads the state, the images and every question in one pass and returns every answer directly. It generates no text, which is why output is free and why the answer always has the shape its type defines.

Calling it#

curl https://api.decisionnode.com/v1/decide \
  -H "Authorization: Bearer $DECISIONNODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "decisionnode",
    "state": "Customer: I was charged twice and nobody has replied for 3 days.",
    "questions": {
      "route": {
        "type": "choice",
        "instructions": "Where should this go?",
        "criteria": {
          "billing": "money",
          "bug": "broken",
          "account": "login"
        }
      },
      "urgency": {
        "type": "score",
        "instructions": "How urgent is this?",
        "criteria": ["routine", "today", "urgent", "critical"]
      },
      "refund": {
        "type": "truth",
        "instructions": "Refund this automatically?"
      }
    }
  }'

The same request costs $0.0000026 on DecisionNode. Compare it with DecisionNode Flash on your own inputs in the playground: the model picker switches between them without changing anything else.

When it has no ready capacity#

Now and then DecisionNode has no ready capacity for a request, for example while more of it is being brought up. Rather than make you wait, the request is answered at once by DecisionNode Flash, with the same questions and the same answer shapes, and billed at DecisionNode Flash's price. The answer says so: model is decisionnode-flash-0.9.1-rc1, and two headers name what happened.

  • Nothing extra ("fallback": true, the default)

    You get
    A 200 from DecisionNode Flash: model decisionnode-flash-0.9.1-rc1, x-decisionnode-fallback: decisionnode-flash-0.9.1-rc1, x-decisionnode-requested-model: decisionnode-main-0.9.1-rc1
    Billed
    At DecisionNode Flash's price
  • "fallback": false

    You get
    529 overloaded_error with Retry-After: the time DecisionNode needs to be ready, or 30 s
    Billed
    Nothing
  • Anything, in a workspace whose fallback policy is never

    You get
    The same 529 as false
    Billed
    Nothing
A request for DecisionNode with no ready capacity
You sendYou getBilled
Nothing extra ("fallback": true, the default)A 200 from DecisionNode Flash: model decisionnode-flash-0.9.1-rc1, x-decisionnode-fallback: decisionnode-flash-0.9.1-rc1, x-decisionnode-requested-model: decisionnode-main-0.9.1-rc1At DecisionNode Flash's price
"fallback": false529 overloaded_error with Retry-After: the time DecisionNode needs to be ready, or 30 sNothing
Anything, in a workspace whose fallback policy is neverThe same 529 as falseNothing
  • Opt out when the decision needs DecisionNode: a re-check of an unsure DecisionNode Flash answer, or a decision you pinned to decisionnode-main-0.9.1-rc1. Send "fallback": false and retry the 529 after Retry-After, as for any 529.
  • Or for the whole workspace: an Owner or Admin turns off DecisionNode Flash fallback in the console's settings (the workspace's fallback policy never); a request's "fallback": true cannot override it.
  • Log the model that answered. Read model (or x-decisionnode-fallback) rather than assuming the one you asked for: thresholds tuned on DecisionNode may need their own values on DecisionNode Flash.
  • DecisionNode Flash has no fallback. A DecisionNode Flash request with no ready capacity is the usual 529.
  • POST /v1/decide for decisionnode-main-0.9.1-rc1 or decisionnode

    With no ready capacity
    Answered by DecisionNode Flash, unless the request or the workspace opts out
  • Opening a session

    With no ready capacity
    Never falls back: 529 with Retry-After; open it again after the wait
  • A batch line

    With no ready capacity
    Never falls back: the line waits in the batch's queue, within the batch's 24 hours
  • A fine-tuned model, on either base

    With no ready capacity
    Never falls back: 529 with Retry-After. You asked for your own model, so nothing else answers in its place
  • DecisionNode Flash

    With no ready capacity
    No fallback: 529 with Retry-After
Where the fallback applies
CallWith no ready capacity
POST /v1/decide for decisionnode-main-0.9.1-rc1 or decisionnodeAnswered by DecisionNode Flash, unless the request or the workspace opts out
Opening a sessionNever falls back: 529 with Retry-After; open it again after the wait
A batch lineNever falls back: the line waits in the batch's queue, within the batch's 24 hours
A fine-tuned model, on either baseNever falls back: 529 with Retry-After. You asked for your own model, so nothing else answers in its place
DecisionNode FlashNo fallback: 529 with Retry-After
Opting out for one request
curl https://api.decisionnode.com/v1/decide \
  -H "Authorization: Bearer $DECISIONNODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "decisionnode",
    "state": "Customer: I was charged twice and nobody has replied for 3 days.",
    "questions": {
      "route": {
        "type": "choice",
        "instructions": "Where should this go?",
        "criteria": {
          "billing": "money",
          "bug": "broken",
          "account": "login"
        }
      },
      "urgency": {
        "type": "score",
        "instructions": "How urgent is this?",
        "criteria": ["routine", "today", "urgent", "critical"]
      },
      "refund": {
        "type": "truth",
        "instructions": "Refund this automatically?"
      }
    },
    "fallback": false
  }'
previousWhen a rule does not appearnextDecisionNode Flash

DecisionNode is built and run by Bynn Intelligence, Inc.

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

on this page

  1. When to use it
  2. How it answers
  3. Calling it
  4. When it has no ready capacity