# System One API

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

System One использует нативный JSON-формат TypeSafe для тех же моделей Decisions и тот же API-ключ. Цена берётся из каталога выбранной модели.

## Текст и JSON

Используйте `decision.json` из [примера Decisions API](/ru/docs/decisions), заменив путь запроса:

```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` выполняет ту же операцию. Не добавляйте `/v1` дважды при настройке base URL.

## Отличия от Decisions API

* `instructions` в вопросе может быть пропущено или равно `null`.
* Choice возвращает `choice`, `confidence` и `probabilities`.
* Score возвращает `score`, `confidence`, `probabilities` и `legend`.
* Noul возвращает `noul`, число от 0 до 1.
* Box возвращает `box` с границами `top`, `bottom`, `left`, `right` от 0 до 1 и `confidence`.

Максимум для Choice: 255 вариантов, для Score: 10 уровней; конкретная модель может иметь меньшие ограничения. Доступные типы вопросов и контекст указаны в каталоге.

## Изображения и Box

Эта возможность доступна только для моделей с поддержкой изображений и Box в System One. Добавьте заголовок `typesafe-danger-zone-images: true`. Передавайте PNG/JPEG в `assets`, поле `data_base64` содержит только Base64 без префикса `data:`. Multipart-загрузка не поддерживается.

Структура тела ниже иллюстративная: замените `BASE64_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 отсчитываются от левого верхнего угла изображения. Box сам по себе не доказывает, что объект найден; добавьте вопрос Noul о наличии объекта, если это важно для вашей задачи.

## Расширенный контекст

Если модель поддерживает расширенный контекст, явно включите его заголовком `typesafe-danger-zone-long-context: true`. Значение этих заголовков должно быть ровно `true`; если режим не нужен, не передавайте заголовок. Включение режима не отменяет лимиты модели и размер тела запроса.

Стоимость, учёт токенов и правила повторов описаны в [Decisions API](/ru/docs/decisions). В кабинете можно попробовать модель без написания кода через выбор модели в чате.

## Решение проблем


**Почему модель недоступна?**


Проверьте выбранное рабочее пространство, доступ к модели и баланс. Если Jev отсутствует в каталоге Decisions, он пока не подключён для вашего доступа.


**Что делать после тайм-аута?**


Сначала проверьте [использование](/ru/docs/usage-costs) за время запроса. Отсутствие ответа не означает отсутствие списания. Повторную отправку запускайте осознанно.
