---
title: "Ask named questions about a state (System One format)"
method: POST
path: "/systemone"
tags: ["decisions"]
---

# Ask named questions about a state (System One format)

`POST /systemone`

## Request

- Base URL: `https://api.sea-lion.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sea-lion.ai/systemone`
- Auth: API key in header `x-litellm-api-key`

Judge a `state` against 1 to 128 named `questions` and get one calibrated answer per question name.

Question types are `noul` (probability the answer is yes), `choice` (one label out of `criteria`, with
`confidence` and `probabilities`), `score` (an index into the `criteria` levels, with `confidence`,
`legend` and `probabilities`) and `box` (the image region the `instructions` describe, with `confidence`).
TypeSafe models also take images in `assets`, each one referenced by its key in `state`. Requests that break
these rules are rejected with a 400 before any provider is called. `model` is any decision model in the proxy model list. OpenAI decision models accept this format
too, LiteLLM translates it and keeps the answers keyed by question name. Streaming is not supported.

[Docs](https://docs.litellm.ai/docs/decisions)

## Request body

- object
  - `audio` union[]: Clef-omni only. Up to 4 embedded audio clips, each a base64 data URL or {content_type, base64}
    - union
      - string
      - object
        - `content_type` string, required: An audio/* media type, such as audio/wav
        - `base64` string, required: Base64-encoded audio bytes
  - `videos` union[]: Clef-omni only. Up to 2 embedded videos, each a base64 data URL or {content_type, base64}
    - union
      - string
      - object
        - `content_type` string, required: A video/* media type, such as video/mp4
        - `base64` string, required: Base64-encoded video bytes
  - `state` union, required: The thing being judged, such as a support ticket, a document or a chat transcript
    - string
    - object
    - unknown[]
      - unknown
  - `questions` object, required: Named noul, choice and score questions. Each key becomes a key in the answers
  - `images` union[], nullable: Images as data URLs or content_type plus base64, for providers that look at images
    - union
      - string
      - object
        - `content_type` string, required: An image/* media type, such as image/png
        - `base64` string, required: Base64-encoded image bytes
  - `assets` object, nullable: TypeSafe only. Images keyed by a reference string. Write the reference in state, instructions or criteria where the image belongs
  - `model` string, required: A decision model from the proxy model_list

## Response `200`

Successful Response

- DecisionsResponse
  - `model` string, nullable
  - `answers` object, required
  - `usage` DecisionsUsage
    - `input_tokens` integer
    - `output_tokens` integer

## Changes

- **2026-10-21** `f2fb14eab3f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sea-lion/apis/litellm-api/changes/systemone/post.md)

---

[API](https://skmtc.dev/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.dev/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sea-lion/apis/litellm-api/revisions/1ba9123c189a?raw)