OrlimeGateway
МоделиДокументацияЗащита данныхКонтакты
Войти
Документация API

Начало работы

Быстрый стартАвторизация и заголовки

Работа с API

Потоковые ответыВызов инструментовРассуждения моделиПродолжение диалоговТокены и стоимостьОшибки и повтор запросов

Текст и данные

Список моделейGETChat CompletionsPOSTResponsesPOSTEmbeddingsPOSTРанжированиеPOSTКлассификацияPOST

Изображения, аудио и видео

Генерация изображенийPOSTСинтез речиPOSTТранскрибацияPOSTСоздание видеоPOSTСтатус видеоGETСкачивание видеоGET
Базовый адресgateway.orlime.ru/v1Открыть каталог моделей

ORLIME GATEWAY / API REFERENCE

Классификация

Задайте несколько вопросов к одному тексту: выберите категорию, оцените вероятность или определите положение на шкале.

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
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 знаками после запятой. Отсутствие поля не означает бесплатный запрос.
JSON
{
  "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 для поиска запроса. Формат и справочник ошибок

Предыдущий разделРанжированиеСледующий раздел Генерация изображений
© 2026 Orlime Gateway
ДокументацияКонтактыTelegramЗащита данныхПолитика конфиденциальностиСогласие на обработку персональных данныхПубличная офертаФайлы cookie