Skip to main content
The Decision API answers questions about a piece of text with probabilities. You send one state (an email, a ticket, a document, a JSON record) and up to 128 named questions about it. Each answer comes back as numbers your code can branch on directly:
  • noul: the probability that the answer to a yes/no question is yes.
  • choice: the most likely of your named options, plus the probability of every option.
  • score: a position on your own ordinal scale, plus the probability of every level.
One endpoint does the work: POST https://api.torchcast.ai/v1/decisions. It uses the standard decisions API request and response shape, so moving an existing integration means changing the base URL, the API key and the model id.

Quickstart

Get a key and make your first request in a few minutes.

Concepts

Questions, answer types, and how to read the probabilities.

API reference

Every field, with request and response examples to copy.

Migrating

Move an existing decisions integration.

​
How it works

  1. Create an API key in the console. Keys start with tcd_.
  2. Send a request with your key as a bearer token.
  3. Each successful request is charged from your prepaid balance by its billable input tokens. Errors are never charged. See Billing.
Prices and per-model limits are published live by GET /v1/models. They are not repeated in these docs.