Перейти к основному содержанию
POST
Оценка решений
Эндпоинт передаёт модели набор именованных вопросов о состоянии и возвращает оценку по каждому вопросу. Работает с моделями из каталога GET /api/v1/models, у которых в capabilities есть значение "decisions" — такие модели не принимают диалог, а отвечают на вопросы одним из трёх типов.

Минимальный запрос

Сначала получите идентификатор модели из каталога, отфильтровав его по capabilities:
cURL
Идентификатор модели берите из GET /api/v1/models и подставляйте как есть. Состав моделей меняется, поэтому в рабочем коде не зашивайте его литералом. Если передать идентификатор обычной текстовой модели или неизвестное значение, придёт 404 с кодом model_not_found.

Поля запроса

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

noul — модель отвечает числом от 0 до 1. criteria — объект с ключами "true" и "false", значения поясняют, что означает каждый полюс:
choice — модель выбирает один вариант. criteria — непустой объект, ключи — варианты ответа, значения поясняют их:
score — модель ставит оценку по шкале. criteria — непустой массив, элементы упорядочены от худшего к лучшему:
Форма criteria проверяется до обращения к модели: для noul нужны оба ключа "true" и "false", для choice — непустой объект, для score — непустой массив. Нарушение даёт 400 invalid_request, а не испорченный ответ.

Ответ

200 OK:
Ключи объекта answers совпадают с именами вопросов из запроса. Поля ответа зависят от типа вопроса: Поля confidence, legend и probabilities модель может не вернуть — проверяйте их наличие перед чтением.

Стоимость

Списание с кошелька идёт по токенам, как у запросов чату: цены модели — те же cost_context и cost_completion из GET /api/v1/models. Поле usage.cost — сумма, списанная с вашего баланса за вызов. Фактический остаток после вызова проверяйте через GET /api/v1/balance.

Проверки перед вызовом

Часть ошибок возвращается до обращения к модели: Ошибки приходят в конверте OpenAI — объект error с полями message, type, param и code. Полная таблица кодов — на странице Ошибки.

Что дальше

Каталог моделей

Поле capabilities и цены моделей

Запрос чату

Диалоговые запросы к текстовым моделям

Баланс

Остаток кошелька по валютам

Ошибки

Полная таблица кодов

Авторизации

Authorization
string
header
обязательно

API-ключ в формате sk-.... Альтернативно — заголовок X-Api-Key: sk-... (совместимо с Anthropic SDK).

Тело

application/json
model
string
обязательно

Идентификатор модели из GET /api/v1/models: у неё в capabilities есть значение "decisions". Передаётся как есть.

questions
object
обязательно

Именованные вопросы. Ключ — имя вопроса, значение — объект вопроса.

state
any
обязательно

Состояние, которое модель оценивает. Любой JSON: строка, объект или массив. Обязательно и не может быть null.

session_id
string

Ключ сессии. Необязательно.

Maximum string length: 256
user
string

Идентификатор пользователя на вашей стороне. Необязательно.

Maximum string length: 256

Ответ

Оценка по каждому вопросу.

id
string
model
string

Идентификатор модели.

provider
string

Провайдер модели.

answers
object

Оценка по каждому вопросу: ключ — имя вопроса из запроса.

usage
object