Введение
Поместите исходные сведения в state и задайте вопросы типов noul, choice или score. Каждый вопрос анализирует state независимо, а ответы возвращаются под указанными вами именами. Весь запрос должен укладываться в 64k токенов, а state вместе с каждым вопросом — в 32k.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Структурированные данные |
| Разработчик и модель | TypeSafe — Jev 1.14 (jev-1.14.0) |
| Дата выпуска | 14 октября 2026; предыдущая сборка Jev 1.13 |
| Публичное имя API | typesafe/jev-1.14/decision |
| Входные данные state | Строка, объект JSON или массив JSON |
| Типы вопросов | noul, choice и score |
| Вопросов за вызов | До 64, независимо и параллельно |
| Ограничения контекста | 64k токенов на запрос; 32k на state с одним вопросом |
| Варианты choice | 1–255 именованных вариантов с описаниями |
| Шкала score | 2–10 упорядоченных уровней по возрастанию |
| Результат задачи | output.decision содержит ответы и inputTokens |
| Измеренная задержка | Около 0,6 с в наших вызовах; ранний замер — 0,62 с |
| Единица тарификации | Измеренные входные токены; выходные бесплатны |
Ключевые возможности и особенности
Вероятность, категория или балл
Выберите один из 3 типов вопросов под нужное коду значение. noul возвращает вероятность «да» от 0 до 1; choice — именованный вариант, confidence и вероятности вариантов; score — взвешенный по вероятностям уровень, confidence, legend и вероятности уровней.
Общий state, независимые суждения
До 64 вопросов независимо и параллельно анализируют один state, поэтому добавление вопросов мало влияет на задержку. Одновременно запросите команду для обращения, срочность и намерение вернуть оплату, а затем объедините ответы в логике приложения.
Оценивайте неопределённость вместе с ответом
При разборе короткого видео оценка доказательности составила 1,44 при confidence 0,28, а вероятность предложения — 0,98. Это разные суждения: явное предложение ещё не означает столь же убедительного подтверждения свойств товара.
Определяйте эскалацию в коде
Задайте пороги вероятности и confidence для передачи материала человеку или генеративной модели. Jev 1.14 даёт структурированные суждения без письменного обоснования, поэтому проверяйте исходные сведения, если сомнительный ответ влияет на дальнейшее действие.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
questions | Да | Задайте имена, типы и instructions для не более 64 вопросов. |
state | Да | Передайте строку, объект или массив JSON со сведениями для всех суждений: вопрос не может опираться на ответ другого вопроса. Не менее 1 символов |
Стоимость
$0.0000504 / 1 000 токенов
Оплата за измеренное число входных токенов; выходные токены бесплатны. При приёме резервируется сумма исходя из предела 64k токенов, разница освобождается после расчёта по запросу.
Сценарии использования
Проверка текста короткой видеорекламы
Передайте в state расшифровку ролика о товаре, экранный текст и описания кадров, затем спросите о приёме привлечения внимания, доказательности и предложении. В показанном примере получены problem, оценка доказательности 1,44 и вероятность предложения 0,98; затрачено 537 входных токенов.
Направление обращения об оплате
Отправьте сообщение вроде «После отмены с меня списали деньги; верните плату за продление» с нужными данными аккаунта. Запросите команду, срочность и намерение возврата: наш пример дал billing, срочность 1,6 и refund_requested 0,96 при 422 входных токенах.
Отделение тональности от намерений
По отзыву «Покрытие скололось, но я бы заказал снова, если это исправят» задайте отдельные вопросы о тональности, проблеме и готовности вернуться. Наш пример вернул sentiment 1,45, проблему quality и would_return 0,97 при расходе 435 входных токенов.
Контроль объявления перед публикацией
Передайте заголовок, описание и обязательные поля объявления, затем спросите, согласован ли заголовок с описанием и присутствует ли нужная деталь. Вероятности «да» используйте как условия публикации, а неоднозначные объявления оставляйте на ручную проверку.
Оценка лида перед передачей дальше
Передайте запрос вроде «В следующем месяце нам нужно внедрение для команды» с имеющимися полями компании и сроков. Опишите уровни готовности и спросите, каких сведений недостаёт; по оценкам и неопределённости определите, каким лидам нужен уточняющий ответ генеративной модели.
Руководство по промптам и практические советы
Подготовьте общий state
Разместите обращение, расшифровку или отзыв в state в виде строки, объекта или массива JSON. Добавьте сведения для каждого вопроса: вопросы не видят ответы друг друга.
Задайте вопросы с типами
Укажите имя, тип и instructions каждого вопроса; в criteria опишите варианты выбора или упорядоченные уровни оценки. Используйте noul для вероятности «да», choice для категории и score для шкалы.
Вызовите эндпоинт решений
Отправьте POST /api/v1/jobs/createTask?wait=30 с model равным typesafe/jev-1.14/decision и полями state и questions внутри input. Прочитайте output.decision завершённой задачи либо создайте задачу и опрашивайте recordInfo.
Проверьте ответы и задайте маршруты
Прежде чем выбирать пороги, сравните вероятности и confidence с ручной разметкой собственной выборки. Направляйте спорные случаи на проверку и сохраняйте inputTokens вместе с решениями.
Jev 1.14 API для типизированных решений
Jev 1.14 — модель принятия решений System One от TypeSafe для классификации и оценки текста или JSON. Эндпоинт возвращает вероятности «да», именованные варианты и оценки по шкале без генерации связного текста или рассуждений. Ответы можно применять для распределения обращений, проверки отзывов и эскалации.
Отправка запроса на решение
Вызовите POST /api/v1/jobs/createTask?wait=30 с публичным именем модели typesafe/jev-1.14/decision. Этот иллюстративный запрос об оплате не относится к нашему измеренному примеру.
{
"model": "typesafe/jev-1.14/decision",
"input": {
"state": {
"message": "I cancelled before renewal but was charged again. Please refund it today."
},
"questions": {
"team": {
"type": "choice",
"instructions": "Which team should handle this message?",
"criteria": {
"billing": "Charges, renewals and refunds",
"technical": "Product errors and access problems"
}
},
"urgency": {
"type": "score",
"instructions": "How urgently does this message request action?",
"criteria": ["No time pressure", "Action requested soon", "Immediate action requested"]
},
"refund_requested": {
"type": "noul",
"instructions": "The customer is asking for money back",
"criteria": {
"true": "A refund or repayment is requested",
"false": "No refund or repayment is requested"
}
}
}
}
}
Чтение результата задачи
Готовый результат содержит output.decision.answers и output.decision.inputTokens. Можно также создать задачу и опрашивать recordInfo. Ниже показаны отдельные поля измеренного ответа на обращение в поддержку.
{
"output": {
"decision": {
"answers": {
"team": {"choice": "billing", "confidence": 1.0},
"urgency": {"score": 1.6, "confidence": 0.4},
"refund_requested": {"noul": 0.96}
},
"inputTokens": 422
}
}
}
Параметры и типы ответов
В state находятся общие сведения для не более 64 вопросов, которые обрабатываются независимо и параллельно.
| Поле | Допустимое значение | Применение |
|---|---|---|
state | Строка, объект или массив JSON | Обозначьте поля исходных сведений |
questions | Объект с именами, заданными вызывающей стороной | Сопоставляйте ответы с проверками |
type | noul, choice, score | Выберите вероятность «да», категорию или упорядоченную оценку |
instructions | Инструкция к вопросу | Запрашивайте одно конкретное суждение |
criteria для noul | Необязательные описания true / false | Уточните обе трактовки при неоднозначной формулировке |
criteria для choice | 1–255 именованных вариантов с описаниями | Определите границы категорий |
criteria для score | Описания 2–10 упорядоченных уровней | Расположите шкалу по возрастанию |
Ответ noul — вероятность «да» от 0 до 1. choice возвращает choice, confidence и probabilities для вариантов. score возвращает взвешенный по вероятностям score, confidence, соответствие уровней описаниям в legend и probabilities уровней. Дробные оценки ожидаемы: читайте их в контексте своей шкалы, а не как метки категорий.
Уточнение критериев решения
Явные исходные данные и критерии помогают задать полезные правила маршрутизации:
- Включите в state все факты, от которых зависит суждение: ответ другого вопроса недоступен.
- Опишите границы категорий и уровни оценок конкретными словами вместо нерасшифрованных меток.
- Для разных факторов, например намерения вернуть оплату и срочности, задавайте отдельные вопросы и объединяйте ответы в коде.
- Сравните размеченную выборку с вероятностями и confidence и по расхождениям подберите пороги ручной проверки.
Низкий confidence означает неопределённость: передайте случай человеку или генеративной модели. У noul отдельного поля confidence нет.
Результаты наших примеров
Наши вызовы занимали около 0,6 с; в более раннем замере 3 вопроса обрабатывались за 0,62 с с расходом 425 входных токенов. В анонсе выпуска TypeSafe указывает полную задержку 70–500 мс; это заявление разработчика, отдельное от наших наблюдений.
| Пример | Отдельные результаты | Входные токены |
|---|---|---|
| Разбор короткого видео | hook: problem, confidence 1,0; proof: 1,44, confidence 0,28; has_offer: 0,98 | 537 |
| Распределение обращения | team: billing, confidence 1,0; urgency: 1,6, confidence 0,4; refund_requested: 0,96 | 422 |
| Проверка отзыва | sentiment: 1,45, confidence 0,32; issue: quality, confidence 1,0; would_return: 0,97 | 435 |
Уверенный выбор категории может сочетаться с неопределённой оценкой; эти примеры не подтверждают точность на вашей выборке.
Стоимость и расход
Тарифицируются измеренные входные токены, выходные бесплатны. Сверяйтесь с ценой на странице и отслеживайте inputTokens. При приёме запроса сумма резервируется исходя из предела 64k токенов; после расчёта по задаче разница освобождается.
Ограничения и устранение проблем
Допустимы до 64 вопросов, 64k токенов на весь запрос и 32k токенов на state вместе с любым одним вопросом. При превышении контекста сократите state или criteria: даже после уменьшения числа вопросов один из них может оставаться слишком большим.
Поддерживаются текст и JSON; файлы изображений, видео, аудио и вопросы box недоступны. Представьте ролик расшифровкой, экранным текстом или описаниями кадров. При отклонении запроса перед повторной отправкой проверьте типы вопросов, структуру criteria, число вариантов и оба предела контекста. При неверном суждении пересмотрите исходные сведения и критерии.
Выбор Jev или другого подхода
Jev подходит для типизированных суждений, генеративная модель — для связного текста.
| Вариант | Подходящая задача |
|---|---|
| Jev 1.14 | Вероятности, категории и оценки по шкале |
| Jev 1.13 | Предыдущая сборка; сравнение с замерами здесь не проводилось |
| Генеративная модель | Письменное объяснение или ответ |
| Ручная проверка | Неоднозначные сведения или неуверенные суждения |
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "typesafe/jev-1.14/decision",
"input": {
"state": "example",
"questions": {
"example": {
"type": "noul",
"instructions": "The customer asks for a refund after being billed twice."
}
}
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.
