# POST systemone — TypeSafe

Строгая схема, изображения, конвертация и оплата TypeSafe System One через хаб.

`POST /typesafe/api/v1/systemone` возвращает решения Jev или модели OpenAI Decisions через конвертацию. Поля запроса и ответа описаны в [документации TypeSafe System One](https://docs.typesafe.ai/api/system-one).

```bash
curl https://hub.coreinfra.ai/typesafe/api/v1/systemone \
  -H "Authorization: Bearer $COREINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"jev-1.14.0","state":"2 + 2","questions":{"sum":{"type":"choice","instructions":"Выберите результат","criteria":{"4":null,"5":null}}}}'
```

Ожидаемый выбор — `4`. Фрагмент ответа:

```json
{"model":"jev-1.14.0","answers":{"sum":{"type":"choice","choice":"4"}}}
```

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

### Поля и вложения

Поле `inference_geo` игнорируется. Схема запроса строгая: неизвестные поля верхнего уровня, вопроса или asset отклоняются со статус-кодом `400`. Параметры генеративных протоколов, включая `stream`, не принимаются.

При JSON-вызове используйте встроенные `assets` с `data_base64` в кодировке base64; оставшаяся ссылка `assets.*.part` отклоняется со статус-кодом `400`. Поддерживаются изображения PNG и JPEG, значения `format` — `png`, `jpg`, `jpeg`.

Для `multipart/form-data` хаб преобразует загрузку в JSON перед выполнением запроса:

* Первая часть должна называться `request` и иметь `Content-Type: application/json` с телом System One.
* Имена частей должны быть непустыми и уникальными. Каждая файловая часть должна использоваться ровно одним asset через `part`.
* Для файловой части допустимы `image/png`, `image/jpeg`, `image/jpg`, `application/octet-stream` либо отсутствие `Content-Type`.
* Данные файла заменяют `data_base64`, если оно тоже задано. Если у asset отсутствует `format`, он определяется по сигнатуре PNG или JPEG; другая сигнатура отклоняется.

Для оценки изображений действует предел работы поиска ссылок: до `1000000` операций и `64 MiB` просматриваемого текста на запрос. Превышение отклоняется со статус-кодом `400` с сообщением `System One image estimation exceeds the work limit; use non-overlapping image identifiers`.

### При конвертации в OpenAI Decisions

Выбирается модель с поддержкой OpenAI Decisions, например `gpt-6-luna`. Генеративная модель без decision-протокола не подходит.

`noul` без критериев преобразуется в `predicate`; с критериями — в `choice` со значениями `false` и `true`. `choice` сохраняет строковые варианты, `score` получает уровни с индексами критериев. В ответе восстанавливаются имена вопросов, `legend` и формат System One; `confidence` пересчитывается для этого формата. Вопрос `box` отклоняется со статус-кодом `400`.

Изображения PNG и JPEG преобразуются во встроенные вложения OpenAI. Требуется непустой стандартный base64 с padding. Ссылки на изображения не должны быть пустыми: максимум `1024` байта на ссылку и `65536` байт суммарно. Преобразованный JSON ограничен `32 MiB`; поиск ссылок — `1000000` операций и `64 MiB` просмотренного текста. Превышения отклоняются со статус-кодом `400`.

Заголовки `typesafe-danger-zone-images` и `typesafe-danger-zone-long-context` применяются только для моделей TypeSafe и при конвертации в OpenAI Decisions игнорируются.

### Оплата

До отправки резервируется стоимость оцененного входа; окончательный расчет использует фактическое число входных токенов `usage.input_tokens`. Правила списания — на странице [«Стоимость моделей принятия решений»](https://coreinfra.ru/docs/billing/decisions.md), цены — на [«Тарифах»](https://hub.coreinfra.ai/pricing).

Некорректный ответ после принятого запроса не означает бесплатное выполнение: хаб учитывает доступный usage, а при его отсутствии может списать зарезервированную оценку.

## Ошибки

* `400` — нет `model`, модель не поддерживает Decisions, JSON не соответствует строгой схеме, multipart не может быть нормализован, нарушены ограничения изображений или запрошен `box` при конвертации.
* `502` — ошибка на стороне провайдера модели при выполнении запроса либо отказ по вопросу в OpenAI Decisions, который не представим в формате System One.

Ошибки проверки возвращаются в формате ошибок TypeSafe System One (пример приведен в [разделе TypeSafe API](https://coreinfra.ru/docs/reference/typesafe.md#errors)); при конвертации ошибка OpenAI Decisions приводится к этому же формату с сохранением статус-кода. Ошибки ключа, выбора модели, баланса и общие статус-коды описаны в [общем справочнике](https://coreinfra.ru/docs/reference.md#errors); ограничения — в разделе [«Лимиты и ограничения»](https://coreinfra.ru/docs/limits.md).
