Decisions API
Jev: типизированные ответы, примеры запросов, стоимость и ограничения.
Обновлено
Jev от TypeSafe отвечает на конкретные вопросы о данных: выбирает категорию, оценивает условие или выставляет оценку. Результат содержит типизированные значения и вероятности. Для обычного диалога выберите текстовую модель.
Выбрать модель
Откройте каталог моделей и вкладку Decisions. Доступность, цена, контекст и поддерживаемые возможности указаны в каталоге. Jev появляется после подключения модели; приведённый ниже ID используйте только если он доступен в вашем рабочем пространстве.
В кабинете откройте Чат → выбор модели → Decisions → Jev. Заполните контекст и вопросы, затем нажмите кнопку запуска. Выбор другой модели возвращает обычный чат и сохраняет его историю. Сам выбор модели не отправляет платный запрос.
Первый запрос
Используйте свой API-ключ с разрешением на инференс и доступом к выбранной модели. Сохраните тело в decision.json и выполните команду:
export PROVOD_API_KEY="sk_..."
curl --fail-with-body --silent --show-error https://api.provod.ai/api/alpha/decisions \
-H "Authorization: Bearer $PROVOD_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @decision.json{
"model": "typesafe/jev-1.14",
"state": {"order": 1042, "paid": true},
"questions": {
"paid": {"type": "noul", "instructions": "The order is paid."},
"action": {
"type": "choice",
"instructions": "Choose the next action.",
"criteria": {"ship": null, "request_payment": null}
},
"priority": {
"type": "score",
"instructions": "Rate delivery urgency.",
"criteria": ["Normal", "Urgent"]
}
}
}Типы вопросов
| Тип | Что передать | Как прочитать ответ |
|---|---|---|
noul | Условие в instructions | noul: вероятность выполнения условия от 0 до 1, не Boolean |
choice | Объект criteria: ключи вариантов и их описания или null | choice: ключ выбранного варианта |
score | Упорядоченный массив criteria | score: позиция на шкале от 0 до количества уровней минус 1; значение может быть дробным |
box | Описание объекта на изображении | Поддерживается через System One при наличии этой возможности у модели |
state принимает строку, объект или массив JSON. questions содержит именованные вопросы; эти же имена будут ключами в answers. В Decisions API поле instructions обязательно для каждого вопроса. Для Choice нужен хотя бы один вариант, для Score хотя бы один уровень. Допустимые размеры и число вариантов зависят от возможностей модели.
Ответ
Иллюстративный ответ: вероятности и количество токенов будут отличаться в реальном запросе.
{
"model": "typesafe/jev-1.14",
"answers": {
"paid": {"type": "noul", "noul": 0.99},
"action": {
"type": "choice", "choice": "ship", "confidence": 0.98,
"probabilities": {"ship": 0.99, "request_payment": 0.01}
},
"priority": {
"type": "score", "score": 0.1, "confidence": 0.8,
"probabilities": {"0": 0.9, "1": 0.1},
"legend": {"0": "Normal", "1": "Urgent"}
}
},
"usage": {"input_tokens": 120, "output_tokens": 0}
}confidence, probabilities и legend могут отсутствовать в Decisions API. Порог принятия решения задаёт ваше приложение. Вероятность не гарантирует правильность ответа.
Форматы и ограничения
| Формат | Путь | Вход |
|---|---|---|
| Decisions API | POST /api/alpha/decisions | Текст и JSON; изображения только при подтверждённой поддержке профилем маршрута |
| System One | POST /v1/systemone | Текст и JSON; PNG/JPEG при поддержке моделью |
Используйте Content-Type: application/json. Потоковая выдача, messages, temperature, tools и max_tokens для этих запросов не поддерживаются. Поддержка изображений и Box в Decisions API зависит от опубликованных и проверенных возможностей выбранного маршрута; не переносите поддержку между протоколами. Для формата assets с PNG/JPEG используйте System One и модель с подтверждённой поддержкой изображений.
Стоимость и повторные запросы
Актуальная цена за миллион входных и выходных токенов указана в каталоге. Несколько вопросов могут увеличивать учитываемый объём входа; ориентируйтесь на usage.input_tokens, а не только на длину state. При запуске баланс временно резервируется, после ответа учитывается фактическое использование.
В ответе API возвращаются usage.input_tokens и usage.output_tokens; поле usage.cost не выдаётся. Фактическое списание смотрите в использовании или результате запуска в кабинете, в валюте вашего баланса.
Ошибки возвращаются в общем формате API. Исправьте некорректные вопросы или недоступные возможности перед повтором. После обрыва соединения сначала проверьте использование: повторная отправка может создать ещё один платный запрос.