POST systemone — TypeSafe
POST /typesafe/api/v1/systemone возвращает решения Jev или модели OpenAI Decisions через конвертацию. Поля запроса и ответа описаны в документации TypeSafe System One.
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. Фрагмент ответа:
{"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. Правила списания — на странице «Стоимость моделей принятия решений», цены — на «Тарифах».
Некорректный ответ после принятого запроса не означает бесплатное выполнение: хаб учитывает доступный usage, а при его отсутствии может списать зарезервированную оценку.
Ошибки
400— нетmodel, модель не поддерживает Decisions, JSON не соответствует строгой схеме, multipart не может быть нормализован, нарушены ограничения изображений или запрошенboxпри конвертации.502— ошибка на стороне провайдера модели при выполнении запроса либо отказ по вопросу в OpenAI Decisions, который не представим в формате System One.
Ошибки проверки возвращаются в формате ошибок TypeSafe System One (пример приведен в разделе TypeSafe API); при конвертации ошибка OpenAI Decisions приводится к этому же формату с сохранением статус-кода. Ошибки ключа, выбора модели, баланса и общие статус-коды описаны в общем справочнике; ограничения — в разделе «Лимиты и ограничения».
