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…
  • Batch jobsPatternsSend up to 10,000 requests in one file and collect the answers later, at half the live price.
  • Pricing and billingYou pay for input tokens only. Output is free because the model generates no text.
↑↓ moveopen7 suggestions
Get API keyGet API key
DecisionNodeDecisionNde

Get started

  • Introduction
  • Quickstart
  • Playground
  • Console and keys
  • With coding agents
  • Examples

Concepts

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

Models

  • DecisionNode-1.0
  • DecisionNode-1.0 Flash
  • Limits
  • Versions
  • Dedicated capacity

Patterns

  • Confidence-gated routing
  • Fan-out
  • Guardrails
  • Control loops
  • Batch jobs

API reference

  • Overview
  • POST/v1/decide
  • GET/v1/models
  • Errors
  • Safety check
  • Rate limits

Sessions API

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

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

Policies

  • Responsible use
  • Data and privacy

Migrate

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

Get started

  • Introduction
  • Quickstart
  • Playground
  • Console and keys
  • With coding agents
  • Examples

Concepts

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

Models

  • DecisionNode-1.0
  • DecisionNode-1.0 Flash
  • Limits
  • Versions
  • Dedicated capacity

Patterns

  • Confidence-gated routing
  • Fan-out
  • Guardrails
  • Control loops
  • Batch jobs

API reference

  • Overview
  • POST/v1/decide
  • GET/v1/models
  • Errors
  • Safety check
  • Rate limits

Sessions API

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

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

Policies

  • Responsible use
  • Data and privacy

Migrate

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

Playground

The playground runs DecisionNode requests in your browser with no key and no cost. Build the state and questions, run them, read the answers, and copy the exact request as curl, Python or TypeScript.

on this page3 sections
  1. What it does
  2. Bring your own request
  3. Open an example by link

Real answers, free and limited

The playground calls the real API and needs no key. Without signing in it runs DecisionNode-⁠1.0 Flash only, up to 60 requests a minute, 4 of them with images; over that it answers 429 with the wait, like the API. Sign in to run DecisionNode-⁠1.0. Use it to learn the shapes and build requests, then send them with a key from the console.

What it does#

  • State

    What it does
    Type or paste the input, as Text or JSON. A JSON state is an object or an array; switch to Text to send a plain string

  • Images

    What it does
    Drop, paste or pick up to 4 images. They are sent in images with the state

  • Questions

    What it does
    Build them with the visual builder (Choice, Score, Truth and Number rows), or switch to JSON and paste a whole questions object. JSON mode checks what you type the way the API does and names each problem by its path

  • Model

    What it does
    Pick DecisionNode-⁠1.0 or DecisionNode-⁠1.0 Flash; only model changes

  • Run

    What it does
    Press Run, or Cmd+Enter (Ctrl+Enter on Windows and Linux) from anywhere on the page

  • Answers

    What it does
    Each answer as a visual: distribution bars for a choice, the level scale for a score, a gauge for a truth, bars over the grid for a number, with the confidence

  • JSON

    What it does
    The exact response body and headers

  • Code

    What it does
    The same request as curl, Python or TypeScript, ready to copy into your code

  • Examples

    What it does
    Presets that load a complete request: a lesson per question type and builds you could ship

  • Tour

    What it does
    A short guided tour of the four parts
The parts of the playground
PartWhat it does
StateType or paste the input, as Text or JSON. A JSON state is an object or an array; switch to Text to send a plain string
ImagesDrop, paste or pick up to 4 images. They are sent in images with the state
QuestionsBuild them with the visual builder (Choice, Score, Truth and Number rows), or switch to JSON and paste a whole questions object. JSON mode checks what you type the way the API does and names each problem by its path
ModelPick DecisionNode-⁠1.0 or DecisionNode-⁠1.0 Flash; only model changes
RunPress Run, or Cmd+Enter (Ctrl+Enter on Windows and Linux) from anywhere on the page
AnswersEach answer as a visual: distribution bars for a choice, the level scale for a score, a gauge for a truth, bars over the grid for a number, with the confidence
JSONThe exact response body and headers
CodeThe same request as curl, Python or TypeScript, ready to copy into your code
ExamplesPresets that load a complete request: a lesson per question type and builds you could ship
TourA short guided tour of the four parts

Bring your own request#

To try a request your code already sends, paste its state into the state editor (JSON mode for an object or an array) and its questions object into the questions editor in JSON mode, then run it against both models. The Code tab gives it back as curl, Python or TypeScript.

Open an example by link#

/playground?example=<id> opens the playground with an example loaded, so a link in your own docs or chat can start someone on the right request. The ids:

  • lesson-choice

    Kind
    Lesson
    What it loads
    Choice: name the commit

  • lesson-score

    Kind
    Lesson
    What it loads
    Score: how severe is this bug report

  • lesson-truth

    Kind
    Lesson
    What it loads
    Truth: was the customer charged twice

  • lesson-number

    Kind
    Lesson
    What it loads
    Number: count the cars in the frame

  • support-triage

    Kind
    Build
    What it loads
    Support inbox that routes itself

  • content-moderation

    Kind
    Build
    What it loads
    Moderation that acts on every comment

  • agent-guardrails

    Kind
    Build
    What it loads
    Guardrail for agent tool calls

  • receipt-check

    Kind
    Build
    What it loads
    Receipt and invoice checker

  • listing-photo

    Kind
    Build
    What it loads
    Listing photo match

  • lead-scoring

    Kind
    Build
    What it loads
    Lead scoring for new signups

  • overdue-invoices

    Kind
    Build
    What it loads
    Statement reader that chases late invoices
Example ids
IdKindWhat it loads
lesson-choiceLessonChoice: name the commit
lesson-scoreLessonScore: how severe is this bug report
lesson-truthLessonTruth: was the customer charged twice
lesson-numberLessonNumber: count the cars in the frame
support-triageBuildSupport inbox that routes itself
content-moderationBuildModeration that acts on every comment
agent-guardrailsBuildGuardrail for agent tool calls
receipt-checkBuildReceipt and invoice checker
listing-photoBuildListing photo match
lead-scoringBuildLead scoring for new signups
overdue-invoicesBuildStatement reader that chases late invoices

Each example's full request and answer, with the code that acts on it, is in Examples. The Examples gallery opens the same ids.

previousQuickstartnextConsole, keys and members

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 it does
  2. Bring your own request
  3. Open an example by link