provod.ai / docs
API

Decisions API

Jev: типизированные ответы, примеры запросов, стоимость и ограничения.

Обновлено

Jev от TypeSafe отвечает на конкретные вопросы о данных: выбирает категорию, оценивает условие или выставляет оценку. Результат содержит типизированные значения и вероятности. Для обычного диалога выберите текстовую модель.

Выбрать модель

Откройте каталог моделей и вкладку Decisions. Доступность, цена, контекст и поддерживаемые возможности указаны в каталоге. Jev появляется после подключения модели; приведённый ниже ID используйте только если он доступен в вашем рабочем пространстве.

В кабинете откройте Чат → выбор модели → Decisions → Jev. Заполните контекст и вопросы, затем нажмите кнопку запуска. Выбор другой модели возвращает обычный чат и сохраняет его историю. Сам выбор модели не отправляет платный запрос.

Первый запрос

Используйте свой API-ключ с разрешением на инференс и доступом к выбранной модели. Сохраните тело в decision.json и выполните команду:

Terminal
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
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Условие в instructionsnoul: вероятность выполнения условия от 0 до 1, не Boolean
choiceОбъект criteria: ключи вариантов и их описания или nullchoice: ключ выбранного варианта
scoreУпорядоченный массив criteriascore: позиция на шкале от 0 до количества уровней минус 1; значение может быть дробным
boxОписание объекта на изображенииПоддерживается через System One при наличии этой возможности у модели

state принимает строку, объект или массив JSON. questions содержит именованные вопросы; эти же имена будут ключами в answers. В Decisions API поле instructions обязательно для каждого вопроса. Для Choice нужен хотя бы один вариант, для Score хотя бы один уровень. Допустимые размеры и число вариантов зависят от возможностей модели.

Ответ

Иллюстративный ответ: вероятности и количество токенов будут отличаться в реальном запросе.

Response
{
  "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 APIPOST /api/alpha/decisionsТекст и JSON; изображения только при подтверждённой поддержке профилем маршрута
System OnePOST /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. Исправьте некорректные вопросы или недоступные возможности перед повтором. После обрыва соединения сначала проверьте использование: повторная отправка может создать ещё один платный запрос.

Решение проблем

На этой странице