---
title: "Evaluate questions with the OpenAI Decisions API"
method: POST
path: "/v1/decisions"
---

# Evaluate questions with the OpenAI Decisions API

`POST /v1/decisions`

## Request

- The document declares no server URL.
- Auth: none declared

Scores questions against shared text input using a cached local
llama_cpp LLM and native logits. This server accepts text only; image
input is unsupported. Candidate probabilities are normalized over the
supplied choices or levels and are not calibrated.

## Request body

- DecisionRequest
  - `model` string: Cached llama_cpp LLM or VLM; omit only when a server model is set via `geniex serve --model` / `GENIEX_MODEL`.
  - `input` union, required: Nonempty text or user messages containing text only. Images are unsupported.
    - string
    - DecisionInputMessage[]
      - `type` 'message'
      - `role` 'user'
      - `content` union, required: Text or an ordered array of input_text parts. Images are unsupported.
        - string
        - DecisionInputTextPart[]
          - `type` 'input_text', required
          - `text` string, required
  - `questions` union[], required: Ordered questions with unique optional names.
    - union
      - DecisionPredicateQuestion
        - `type` 'predicate', required
        - `name` string: Optional unique question name; response name is null if omitted.
        - `instructions` string, required
      - DecisionChoiceQuestion
        - `type` 'choice', required
        - `name` string: Optional unique question name; response name is null if omitted.
        - `instructions` string, required
        - `choices` DecisionChoice[], required
          - `value` union, required
            - string
            - boolean
          - `description` string
      - DecisionScoreQuestion
        - `type` 'score', required
        - `name` string: Optional unique question name; response name is null if omitted.
        - `instructions` string, required
        - `levels` DecisionScoreLevel[], required
          - `label` string, required
          - `description` string
  - `nctx` integer: Context size; defaults to the server setting.
  - `ngl` integer: Number of GPU layers; defaults to the server setting.
  - `compute` string: Compute-unit alias; defaults to the server setting.
  - `power_mode` string: Power mode; defaults to the server setting.

## Response `200`

Answers in question order with token usage

- DecisionResponse
  - `answers` union[], required: One answer for each question, in question order.
    - union
      - DecisionPredicateAnswer
        - `type` 'predicate', required
        - `name` string, nullable, required
        - `probability` number, required
      - DecisionChoiceAnswer
        - `type` 'choice', required
        - `name` string, nullable, required
        - `choice` union, required
          - string
          - boolean
        - `probabilities` DecisionChoiceProbability[], required
          - `value` union, required
            - string
            - boolean
          - `probability` number, required
        - `confidence` number, required
      - DecisionScoreAnswer
        - `type` 'score', required
        - `name` string, nullable, required
        - `score` number, required
        - `probabilities` DecisionScoreProbability[], required
          - `value` integer, required
          - `label` string, required
          - `probability` number, required
        - `confidence` number, required
  - `model` string, required
  - `usage` DecisionUsage, required
    - `input_tokens` integer, required
    - `input_tokens_details` object, required
      - `cache_write_tokens` integer, required
      - `cached_tokens` integer, required
    - `output_tokens` integer, required
    - `output_tokens_details` object, required
      - `reasoning_tokens` integer, required
    - `total_tokens` integer, required

## Other responses

- `400`: Unsupported model or model scoring error
- `413`: Request exceeds 1 MiB
- `422`: Invalid request or unsupported input modality

## Changes

- **2026-10-21** `4abf7fdfd964`: 1 info
  - the request property `model` became optional
- **2026-10-12** `655104224b66`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/qualcomm/apis/geniex-server/changes/v1/decisions/post.md)

---

[API](https://skmtc.dev/qualcomm/apis/geniex-server.md) - [All operations](https://skmtc.dev/qualcomm/apis/geniex-server/llms.txt) - [OpenAPI document](https://skmtc.dev/qualcomm/apis/geniex-server/revisions/47891ae23392?raw)
