Классификация
Задайте несколько вопросов к одному тексту: выберите категорию, оцените вероятность или определите положение на шкале.
POST
/v1/decisionsЗаголовки
AuthorizationBearer <API_KEY>Обязательно- Ключ компании из раздела «API-ключи». Храните на сервере или в переменной окружения. Не вставляйте секретный ключ в браузерный код.
Content-Typeapplication/jsonДля JSON-тела- Кодировка UTF-8. Для файлов используйте multipart/form-data; curl и SDK сами добавят boundary. Для GET и DELETE без тела не нужен.
Acceptapplication/json | text/event-streamНеобязательно- Ожидаемый формат ответа. Для включения SSE нужно также передать stream: true в JSON. Синтез речи и скачивание видео возвращают бинарные данные.
Адрес метода: https://gateway.orlime.ru/v1/decisions
Входные параметры
modelstringОбязательно- Публичный ID из GET /v1/models. Возможности и допустимые параметры смотрите в карточке модели.
statestring | object | arrayОбязательно- Текст и контекст классификации.
questionsobjectОбязательно- Именованные вопросы; ключи будут использованы в answers.
questions.*.typestringОбязательно- choice — категория; noul — вероятность «да»; score — оценка по шкале.
questions.*.instructionsstring | object | arrayОбязательно- Инструкция для конкретного вопроса.
questions.*.criteriaobject | arrayПо типу вопроса- choice: объект категория → описание/null; noul: необязательные описания true/false; score: массив уровней от меньшего к большему.
Пример запроса
curl --fail-with-body https://gateway.orlime.ru/v1/decisions \
-H "Authorization: Bearer $ORLIME_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "typesafe/jev-1.13",
"state": {
"message": "Не могу оплатить счёт, платёж отклоняется второй раз."
},
"questions": {
"category": {
"type": "choice",
"instructions": "К какой категории относится обращение?",
"criteria": {
"billing": "Оплата, счета и списания.",
"technical": "Ошибки API и работа приложения.",
"account": "Вход и настройки аккаунта."
}
},
"needs_help": {
"type": "noul",
"instructions": "Клиенту нужна помощь с возникшей проблемой?"
},
"urgency": {
"type": "score",
"instructions": "Насколько срочно нужно решить проблему?",
"criteria": [
"Обычный вопрос",
"Мешает работе",
"Полностью блокирует работу"
]
}
}
}'Ответ
idstringВ ответе- Идентификатор ответа Gateway. Для текстовых запросов совпадает с заголовком x-request-id. Используйте для обращения в поддержку.
modelstringВсегда- Публичный ID модели.
answersobjectВсегда- Ключи соответствуют вопросам клиента.
answers.*.type / choicestring / stringДля choice- Тип результата и выбранная категория.
answers.*.noulnumberДля noul- Вероятность «да» от 0 до 1.
answers.*.score / legendnumber / objectДля score- Оценка с нуля, в том числе дробная, и подписи шкалы.
answers.*.confidence / probabilitiesnumber / objectЕсли доступны- Уверенность и вероятности категорий.
usageobjectЕсли доступно- input_tokens, output_tokens и total_tokens.
usage.cost_rubstringЕсли расчёт завершён- Сумма фактического списания в рублях за весь запрос. Десятичная строка с 12 знаками после запятой. Отсутствие поля не означает бесплатный запрос.
{
"id": "d2075c15-6fde-4ba8-bfd7-a246f58bce11",
"model": "typesafe/jev-1.13",
"answers": {
"category": {
"type": "choice",
"choice": "billing",
"confidence": 0.95,
"probabilities": {
"billing": 0.95,
"technical": 0.04,
"account": 0.01
}
},
"needs_help": {
"type": "noul",
"noul": 0.98
},
"urgency": {
"type": "score",
"score": 1.8,
"legend": {
"0": "Обычный вопрос",
"1": "Мешает работе",
"2": "Блокирует работу"
}
}
},
"usage": {
"input_tokens": 120,
"output_tokens": 30,
"cost_rub": "0.010000000000"
}
}Заголовки ответа
x-request-idstringОтвет Gateway- ID операции для поиска в журнале и обращения в поддержку. В Chat Completions и Responses совпадает с верхнеуровневым id ответа.
Content-TypestringОтвет Gateway- application/json, text/event-stream или MIME-тип аудио/видео. Ошибки файловых методов могут возвращаться как JSON.
Retry-AfterintegerЕсли возвращён- Число секунд до рекомендуемого повтора. Отсутствие заголовка не означает, что запрос следует немедленно повторять.
Особенности
- messages, temperature и reasoning здесь не используются. Streaming не поддерживается.
Ошибки
Ошибки возвращаются в объекте error с полями message, type, code и param. Сохраните x-request-id для поиска запроса. Формат и справочник ошибок
