Decisions API

Closed questions · text and images

Decisions API

LIVE

Available now in the playground and API. Built on the official OpenAI API.

Define the answers. Send text or images. Get one decision and a probability for every option.

  • 20 free runs
  • Text + images
  • Choice · Yes/No · Score

Decisions API playground

Photo of a receipt plus the employee note. Categorise it and check the policy.

1 Context
Example image receipt.jpg
2 Questions
3 Decisions
Real output · 1.57 s
Choice100% sure

Which expense category does this receipt belong to?

meals
  • meals 100%
  • travel 0%
  • software 0%
  • office 0%
Yes / No100% sure

Is this an itemised receipt with a date and a VAT number, valid for reimbursement?

100%Yes
Yes / No100% sure

Does the receipt include alcohol, so a manager must approve it?

100%Yes

decisions-latest · 3,099 input tokens · recorded 2026-09-29

What you can build with the Decisions API

Whenever the right answer is one item from a known list, the Decisions API is simpler to test and cheaper to run than free-form generation.

Route requests

Send tickets, emails and chats to the right queue with the Decisions API.

Moderate content

Label text and images against your policy; hide only above a threshold.

Steer agents

Let the Decisions API pick an agent's next tool from a closed list.

Guard your LLM

Catch prompt injection and off-policy replies before they ship.

Read documents

Classify receipts, invoices and screenshots straight from the image.

Score and qualify

Rate sentiment, lead fit or risk on your own ordered scale.

Triage at volume

Ask several closed questions about one context in a single call.

Audit decisions

Log every probability and send low-confidence cases to a person.

Three Decisions API question types

Every answer comes from your list. Every option gets a probability.

Choice

Picks one of up to 20 options and shows every probability.

Yes / No

The probability that the answer is yes.

Score

Rates the input on your own ordered levels, with an expected score.

How the Decisions API works

Each question becomes one closed multiple-choice prompt. The model answers with a single letter, and we read the probability it gives every option.

  1. 01Add text or images
  2. 02Define the options
  3. 03Read the probabilities
  4. 04Ship with the API

OpenAI Decisions API, available today

OpenAI announced a Decisions API at DevDay 2026 that returns one of your predefined answers; it is in limited preview. This independent Decisions API follows the same idea on the official OpenAI API now, with self-serve keys, image input and per-option probabilities.

Compare with the OpenAI Decisions API →

Decisions API pricing

Start20 free runs
All paid usageInput tokens only
Web · APICredits first · Tokens first
See plans

Decisions API FAQ

Read: what is a Decisions API?

What is Decisions API?

Decisions API is a playground and API that answers closed questions about text. You define the options; it returns the selected option and a probability for every option instead of free-form prose.

Is this the OpenAI Decisions API?

No. Decisions API is an independent service. It is built on the official OpenAI API and follows the same idea as the OpenAI Decisions API announced at DevDay 2026: a fixed set of answers and a probability for each. It is not affiliated with or endorsed by OpenAI.

Can the Decisions API read images?

Yes. Attach up to 4 images (https URLs or base64 data URLs) as context, alone or together with text. Receipts, screenshots, product photos and documents all work.

How are the probabilities calculated?

Each option is shown to the model as a single letter. We read the probability the model assigns to every letter for its one-token answer and normalise across your options.

How is usage billed?

Playground runs use one welcome credit first. API calls use purchased input tokens first. Each question is one model call, so input tokens grow with the number of questions. Output tokens are free.