Решения

POST /v1/decisions отвечает на типизированные вопросы о ваших данных вероятностями, а не текстом. Используйте его для разметки, проверок и выбора ветки в коде. Формат совместим с TypeSafe POST /v1/systemone: тот же запрос работает, если сменить адрес и ключ.

curl https://api.souz.ai/v1/decisions \
  -H "Authorization: Bearer $SOUZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-1.14",
    "state": {"ticket": "Checkout shows a blank page after I click Pay."},
    "questions": {
      "is_bug": {"type": "noul", "instructions": "Is the customer reporting a software defect?"},
      "team": {"type": "choice", "instructions": "Which team should own this ticket?",
               "criteria": {"payments": "Checkout and billing.", "frontend": "Layout and rendering."}},
      "urgency": {"type": "score", "instructions": "How urgent is this ticket?",
                  "criteria": ["Can wait", "This week", "Blocking revenue"]}
    }
  }'

Поля решений

ПолеТипПо умолчаниюЧто делает
modelstringобязательноМодель с modality: decision
statestring, object или arrayобязательноДанные, о которых вопросы
questionsobjectобязательноВопросы по имени ответа, от одного
questions.*.typestringобязательноnoul, choice, score или box
questions.*.instructionsstring, object или arrayобязательноСам вопрос
questions.*.criteriaпо типунетВарианты, уровни шкалы или смысл «да» и «нет»
assetsobjectнетКартинки по ключу: {"type": "image", "format": "png", "data_base64": "…"}

Общие поля routing, routing_options, max_price_multiplier и store описаны в Авто-роутинг. Ответ всегда синхронный, потока нет.

Типы вопросов

typeВопросcriteriaОтвет
noulВерно ли утверждениеНеобязательно: {"true": "…", "false": "…"}noul, вероятность «да» от 0 до 1
choiceКакой из вариантовОбъект от 1 до 255 вариантов: имя → описание или nullchoice, confidence, probabilities
scoreГде на шкалеМассив от 1 до 10 уровней от низшего к высшемуscore от 0 до n−1, confidence, legend, probabilities
boxГде на картинкеПоля нетbox с top, bottom, left, right и confidence

Какие типы принимает модель, указано в её карточке: params и input_schema. Тип box есть не у всех моделей и требует картинку в запросе.

Картинки в решениях

Передайте картинку в assets под ключом и упомяните этот ключ в state или в вопросе. Формат PNG или JPEG, байты в стандартном base64 без префикса data:.

JSON
{
  "model": "jev-1.14",
  "state": {"photo": "img-3f1c"},
  "assets": {"img-3f1c": {"type": "image", "format": "png", "data_base64": "iVBORw0KGgo…"}},
  "questions": {"product": {"type": "box", "instructions": "the product in img-3f1c"}}
}

Ключ без упоминания получает 400. Сколько картинок принимает модель, указано в limits.max_references карточки. Где модель читает ключ, указано в key_placement поля assets в params. При state_item ключ должен стоять отдельным элементом массива state: "state": ["Photo:", "img-3f1c"]. При anywhere ключ можно указать и внутри текста.

Размер картинки указан в min_side, max_side и max_pixels поля assets. Картинку вне этих пределов мы масштабируем с сохранением пропорций. Рамка box задана долями ширины и высоты, поэтому она относится и к исходной картинке. Слишком вытянутую картинку вписать нельзя, на неё API отвечает 400 capability_mismatch с detail[].path вида assets.img-3f1c.

Ответ решений

JSON
{
  "id": "job_1a2b…",
  "model": "jev-1.14",
  "channel": "blue",
  "answers": {
    "is_bug": {"type": "noul", "noul": 0.95},
    "team": {"type": "choice", "choice": "payments", "confidence": 0.67,
             "probabilities": {"payments": 0.78, "frontend": 0.22}}
  },
  "usage": {"input_tokens": 350, "output_tokens": 38, "cost": 2430, "currency": "RUB"}
}

Оплачиваются только входные токены, выход бесплатен. usage.cost показывает списанное в микроединицах; null значит, что цена ещё уточняется, итог появится в price задачи. id открывает задачу в GET /v1/jobs/{id}. Некоторые модели считают state отдельно для каждого вопроса, поэтому input_tokens растёт с числом вопросов.

Ошибки решений

КодКогдаЧто делать
400 invalid_requestНет state или questions, тип вопроса неизвестен, criteria не по типуИсправьте поле из detail[].path
400 invalid_requestКлюч картинки не упомянут, формат не PNG или JPEG, base64 с префиксомИсправьте assets
400 invalid_requestКартинка частью state или вопроса ({"type": "image_url", …})Перенесите её в assets
400 capability_mismatchМодель не отвечает на box, не принимает картинки или столько вопросовВозьмите модель по params карточки
400 capability_mismatchКартинку не вписать в min_side и max_side модели, detail[].path = assets.<ключ>Обрежьте картинку ближе к квадрату
400 capability_mismatchstate не помещается в limits.context_tokens модели, detail[].path = stateСократите state или возьмите модель с окном больше
400 invalid_requestМодель другой модальности (wrong_endpoint)Отправьте запрос на адрес из detail[].allowed

Остальные коды описаны в Ошибки.

Дальше