Jev — модель решений

Авторизация

• Authorizationheaderобязательный

  Ключ Ailoot в виде Bearer sk-….

Тело запроса

• modelstringобязательный

  jev-latest.

• statestring | object | arrayобязательный

  Что оценивать: строка с текстом или JSON — обращение клиента, запись из базы, переписка, текущее состояние вашего приложения. Объект с понятными именами полей обычно удобнее одной строки.

• questionsobjectобязательный

  Вопросы. Ключи выбираете вы, ответы придут под теми же ключами; на ответ ключ не влияет — сам вопрос задаётся в instructions.

• questions.*.typestringобязательный

  noul, choice или score — см. ниже.

• questions.*.instructionsstring | object | arrayобязательный

  Сам вопрос. Длинный вопрос с данными можно передать объектом: вопрос в одном поле, данные в других; ссылайтесь на поля по имени в обратных кавычках.

• questions.*.criteriaobject | array

  Варианты ответа, свои у каждого типа: описания «да» и «нет» у noul (необязательно), словарь вариантов у choice, упорядоченный список уровней у score.

Типы можно смешивать в одном запросе.

noul — да или нет

Поле criteria необязательно: в нём можно описать, что значит «да» (true) и «нет» (false). Ответ noul — число от 0 (нет) до 1 (да).

"is_urgent": {
  "type": "noul",
  "instructions": "Does this convey urgency?",
  "criteria": {
    "true": "Explicitly time-sensitive",
    "false": "No urgency expressed"
  }
}

"is_urgent": {
  "type": "noul",
  "noul": 0.95
}

choice — выбор варианта

criteria — словарь «вариант → описание»; если описание не нужно, укажите null. До 255 вариантов. В ответе choice — самый вероятный вариант, probabilities — вероятность каждого варианта (в сумме 1), confidence — уверенность от 0 до 1.

"department": {
  "type": "choice",
  "instructions": "Which team should handle this?",
  "criteria": {
    "billing": "Payments, invoicing, refunds",
    "technical": "Bugs, outages, integrations",
    "sales": "Pricing, upgrades, new customers"
  }
}

"department": {
  "type": "choice",
  "choice": "billing",
  "probabilities": { "billing": 0.88, "technical": 0.12, "sales": 0.0 },
  "confidence": 0.81
}

score — оценка по шкале

criteria — уровни от низшего к высшему, не больше 10 (TypeSafe советует не меньше двух). В ответе score — значение, взвешенное по вероятностям уровней (может оказаться между уровнями), legend — номер уровня и его описание, probabilities и confidence. По данным TypeSafe, score годится для сравнения с порогом, но не для точного числа между уровнями.

"frustration": {
  "type": "score",
  "instructions": "How frustrated is the customer?",
  "criteria": ["Calm", "Frustrated", "Very angry"]
}

"frustration": {
  "type": "score",
  "score": 1.05,
  "legend": { "0": "Calm", "1": "Frustrated", "2": "Very angry" },
  "probabilities": { "0": 0.0, "1": 0.95, "2": 0.05 },
  "confidence": 0.92
}

• modelstring

  Какая версия модели ответила. Псевдоним jev-latest со временем переходит на новые версии: если вы подобрали пороги confidence под конкретную версию, следите за этим полем.

• answersobject

  По одному ответу на каждый вопрос, под теми же ключами. У каждого ответа есть type, у choice и score — ещё confidence.

• usageobject

  input_tokens и output_tokens. Оплачиваются только входные токены.

Задавайте все вопросы к одному state одним запросом: они оцениваются параллельно, а state передаётся один раз. По данным TypeSafe, в их примере с 13 вопросами один общий запрос вышел в 12,2 раза дешевле и в 10 раз быстрее, чем 13 отдельных запросов, если отправлять их по очереди, при тех же ответах.

Сложное суждение лучше разбить на простые вопросы и объединить ответы в коде: например, вместо «оцени заявку» — отдельные оценки рынка, реализуемости и отличий от конкурентов. Веса тогда меняются в коде, а не в тексте вопроса.

{
  "model": "jev-latest",
  "state": "Help! My payouts have been failing for 3 days.",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Which team should handle this?",
      "criteria": {
        "billing": "Payments, invoicing, refunds",
        "technical": "Bugs, outages, integrations",
        "sales": "Pricing, upgrades, new customers"
      }
    },
    "frustration": {
      "type": "score",
      "instructions": "How frustrated is the customer?",
      "criteria": ["Calm", "Frustrated", "Very angry"]
    },
    "is_urgent": {
      "type": "noul",
      "instructions": "Does this convey urgency?"
    }
  }
}

• Маршрутизация. Отправить обращение в нужный отдел, а запрос — нужному обработчику: простому коду, большой модели или человеку.
• Сортировка и приоритет. Срочность, тональность, риск — по шкале, с порогами в коде.
• Модерация и проверки. Нарушает ли сообщение правила, подтверждает ли источник цитату, есть ли в документе ответ на вопрос — до того, как текст пойдёт дальше.
• Скоринг и ранжирование. Оценить документы, кандидатов или найденные фрагменты по своей рубрике и решить в коде, что пойдёт дальше.
• Вместо хрупкого «верни JSON». Вызов, который возвращает типизированные значения по построению, а не текст, который нужно разбирать.

• Чат, ответы пользователю, генерация текста или кода. Jev не пишет текст — для этого есть текстовые модели.
• Модель для Claude Code, Cursor и других агентов. Подставить jev-latest вместо модели агента не получится: агенту нужна модель, которая пишет текст и вызывает инструменты. Jev можно вызывать из кода, который агент пишет для вас.
• Арифметика, подсчёт, сравнение дат. По данным TypeSafe, это надёжнее делать в коде, а у модели спрашивать только смысловую часть — например, извлечь части даты через choice.
• Картинки, аудио и видео. Модель принимает только текст — переведите такие данные в текст заранее.

Оплачиваются только входные токены — поле usage.input_tokens ответа: $0.084 за 1 млн. Выходные токены бесплатны.

Запрос из примера на этой странице (296 входных токенов) стоит меньше $0.0001.

Перед запросом Ailoot резервирует сумму на балансе и после ответа списывает один раз по фактическому расходу — как это работает.

Лимиты модели — по данным TypeSafe. Ограничения вашего ключа и баланса действуют как для любой модели Ailoot: Ошибки и лимиты.

Ошибки приходят в общем формате Ailoot API: код, понятный текст и Request ID. Чаще всего у этого метода встречаются:

Полный список кодов — на странице Ошибки и лимиты.