Перейти к содержанию

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 приводится к этому же формату с сохранением статус-кода. Ошибки ключа, выбора модели, баланса и общие статус-коды описаны в общем справочнике; ограничения — в разделе «Лимиты и ограничения».