# System One API

Source: https://provod.ai/en/docs/system-one

System One uses TypeSafe's native JSON format with the same decision models and API key. The selected model's catalog price applies.

## Text and JSON

Use `decision.json` from the [Decisions API example](/en/docs/decisions) with this request path:

```bash
export PROVOD_API_KEY="sk_..."

curl --fail-with-body --silent --show-error https://api.provod.ai/v1/systemone \
  -H "Authorization: Bearer $PROVOD_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @decision.json
```

`POST /api/v1/systemone` is an alias for the same operation. Do not duplicate `/v1` when configuring a base URL.

## Differences from Decisions API

* Question `instructions` may be omitted or `null`.
* Choice returns `choice`, `confidence` and `probabilities`.
* Score returns `score`, `confidence`, `probabilities` and `legend`.
* Noul returns `noul`, a number from 0 to 1.
* Box returns `box` with normalized `top`, `bottom`, `left`, `right` edges from 0 to 1, and `confidence`.

Choice accepts at most 255 options and Score at most 10 levels; individual models can impose lower limits. Check supported question types and context in the catalog.

## Images and Box

Only models with verified image and Box support on System One accept this input. Add `typesafe-danger-zone-images: true`. Supply PNG/JPEG via `assets`; `data_base64` contains raw Base64 without a `data:` prefix. Multipart uploads are not supported.

The body below illustrates the structure. Replace `BASE64_IMAGE_BYTES` with actual encoded image bytes.

```json
{
  "model": "typesafe/jev-1.14",
  "state": "Product photo: product",
  "assets": {
    "product": {"type": "image", "format": "png", "data_base64": "BASE64_IMAGE_BYTES"}
  },
  "questions": {
    "product_region": {"type": "box", "instructions": "The product in the product photo."}
  }
}
```

Box edges are measured from the top-left corner. A box alone does not prove the target exists; add a Noul presence question when your task requires that check.

## Long context

If supported by the model, explicitly enable long context with `typesafe-danger-zone-long-context: true`. Opt-in headers must have the exact value `true`; omit a header when its mode is not needed. These flags do not bypass model context or request body limits.

See [Decisions API](/en/docs/decisions) for costs, usage accounting and retry behavior. To try the model without code, select it from the chat model picker in the cabinet.

## Troubleshooting


**Why is the model unavailable?**


Check your selected workspace, model access and balance. If Jev is absent from the Decisions catalog, it is not enabled for your access yet.


**What should I do after a timeout?**


Check [Usage](/en/docs/usage-costs) for the request time first. No response does not mean no charge. Make an explicit decision before submitting again.
