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, 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 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
  • MCP server
  • Examples

Concepts

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

Models

  • DecisionNode-1.0
  • DecisionNode-1.0 Flash
  • 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
  • Fan-out
  • Guardrails
  • Control loops
  • Batch jobs

API reference

  • Overview
  • POST/v1/decide
  • GET/v1/models
  • POST/v1/uploads
  • 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
  • Refer & earn

Policies

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

Get started

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

Concepts

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

Models

  • DecisionNode-1.0
  • DecisionNode-1.0 Flash
  • 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
  • Fan-out
  • Guardrails
  • Control loops
  • Batch jobs

API reference

  • Overview
  • POST/v1/decide
  • GET/v1/models
  • POST/v1/uploads
  • 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
  • Refer & earn

Policies

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

Start a training run

A run trains a new version of your model on a ready dataset. The console shows the estimate first: the expected time and the fee, 3 × the compute time + $50. Nothing is charged until the run ends, and a run that fails costs nothing.

on this page10 sections
  1. Start it
  2. The estimate and the fee
  3. What a run does
  4. Check
  5. Split
  6. Train
  7. Calibrate
  8. Score
  9. Gate
  10. Train again

Start it#

  1. 1.Open the model in Fine-tuning, choose New training run and a ready dataset.
  2. 2.See the estimate: the compute time the run should take, the expected wall time, and the fee.
  3. 3.Start training. The run gets the next version number, 1, 2, 3 and so on, and appears as queued.
  • The dataset is not ready

    What to do
    Wait for validation, or fix it
  • The dataset belongs to another model

    What to do
    Upload it for this model
  • A run is already queued or running in the workspace (1 at a time)

    What to do
    Wait for it to end
  • The prepaid balance is below the estimate

    What to do
    Add credit under Billing, then start again
When a run cannot start
ReasonWhat to do
The dataset is not readyWait for validation, or fix it
The dataset belongs to another modelUpload it for this model
A run is already queued or running in the workspace (1 at a time)Wait for it to end
The prepaid balance is below the estimateAdd credit under Billing, then start again

The estimate and the fee#

fee = 3 × compute time × compute price

+ $50

compute time
how long the run trains and scores, measured when it ends
compute price
the price of the machine the run uses, recorded when it starts
  • ready

    Charged
    The full fee: 3 × the compute + $50
  • no_gain

    Charged
    $50 only: the compute part is not charged
  • failed

    Charged
    Nothing
  • refused

    Charged
    Nothing: the safety check refused records before any training
  • cancelled

    Charged
    The compute used so far × 3, without the $50; nothing if it had not started. See Cancel a run
What a run is charged, by how it ends
The run endsCharged
readyThe full fee: 3 × the compute + $50
no_gain$50 only: the compute part is not charged
failedNothing
refusedNothing: the safety check refused records before any training
cancelledThe compute used so far × 3, without the $50; nothing if it had not started. See Cancel a run

The estimate comes from the dataset's size and the base, and the fee is charged from the time the run really took, so the charge can differ a little from the estimate. For example, a run whose compute costs $0.70 is charged $52.10 when it ends ready and $50 when it ends no_gain. The fee is drawn from the prepaid balance; every figure is on Limits and pricing.

What a run does#

  1. 1

    Check#

    Runs the safety check over every record's state and images, as a request is checked, before any training. If it refuses a record, the run ends refused: nothing is trained, nothing is charged, and the dataset is marked refused with the record numbers only, never their content.

  2. 2

    Split#

    Deals the records into train, calibration and held out (10% each for the last two, at least 50), keeping records with the same state together.

  3. 3

    Train#

    Trains a new version of the base on the training records, checking itself against the calibration records as it goes and stopping when they stop improving.

  4. 4

    Calibrate#

    Fits the new version's probabilities on the calibration records, so its confidences mean what they say.

  5. 5

    Score#

    Scores the new version and the base side by side: on your held-out records, and on our standard test sets for the same question types.

  6. 6

    Gate#

    Passes the version as ready, or marks it no_gain with the reason. See The quality gate.

A run takes minutes for a small dataset on DecisionNode-⁠1.0 Flash and longer for large datasets and for DecisionNode-⁠1.0; the estimate says how long yours should take. A run is stopped after 6 hours and ends failed, at no charge.

Train again#

  • Every run is a new version. Earlier versions stay as they are, deployed or not, so you can compare and roll back.
  • A model keeps its 5 newest versions; older ones are archived.
  • When the base gets a new release, your deployed versions stay on the base they were trained on and keep answering until that base is retired, announced in the console with a date. Train the same dataset again on the new base, and the gate decides again.
  • Watch a runStates, live progress and what makes a run fail.Read
  • The quality gateFour tests against the base; what no_gain means.Read
nextIntroduction

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. Start it
  2. The estimate and the fee
  3. What a run does
  4. Check
  5. Split
  6. Train
  7. Calibrate
  8. Score
  9. Gate
  10. Train again