# System One

Evaluate typed questions with a System One model.

`POST /api/v1/systemone`

## Overview

TypeSafe System One-compatible endpoint. Provide a state and one or more independent typed questions; CAPI routes the request through the workspace's configured evaluation channel, applies the same key scope and billing as /evaluate, and returns typed answers with CAPI cost metadata.

## Parameters

- `model` (string) — required: An enabled evaluation model ID, e.g. typesafe-ai/jev.
- `state` (string | object | array) — required: Text or structured JSON state to evaluate.
- `questions` (object) — required: Map of question IDs to questions of type noul, choice, or score. Up to 20 questions per request.

## Example

```bash
curl -X POST https://capi.minapp.xin/api/v1/systemone \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"typesafe-ai/jev","state":"I was charged twice.","questions":{"refund_requested":{"type":"noul","instructions":"Does the customer ask for a refund?"}}}'
```

## Response

```json
{
  "model": "typesafe-ai/jev",
  "answers": {
    "refund_requested": { "type": "noul", "noul": 0.97 },
    "urgency": {
      "type": "choice",
      "choice": "high",
      "probabilities": { "low": 0.08, "high": 0.92 },
      "confidence": 0.84
    }
  },
  "usage": { "input_tokens": 52, "output_tokens": 24 },
  "cost": { "amount": 0.0001, "currency": "USD" }
}
```