Основное API

Отправить запрос решений

Схема запроса и ответа POST /api/alpha/decisions.

POST /api/alpha/decisions отправляет состояние и вопросы и возвращает ответы. Как устроены виды вопросов, описано на странице Решения. Разбор первого ответа — на странице Первый вызов.

Авторизация

Ключ передаётся как Bearer в заголовке Authorization.

curl -X POST "https://api.alltokens.ru/api/alpha/decisions" \
  -H "Authorization: Bearer $ALLTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "typesafe/jev-1.14",
    "state": "Страница оплаты остаётся белой после нажатия кнопки.",
    "questions": {
      "is_bug": {
        "type": "noul",
        "instructions": "Клиент сообщает о дефекте программы?"
      }
    }
  }'

Тело

Content-Type: application/json

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

Вопросы. Ключ — ваше имя вопроса, по нему же приходит ответ.

Содержимое, которое нужно оценить: простая строка либо объект или список связанного контекста.

Настройки выбора поставщика для этого запроса.

{ "allow_fallbacks": true }

Уникальный идентификатор для группировки связанных запросов (например, разговор или сценарий помощника). Нужен для группировки в журналах. Поставщику не передаётся. Если указан и в теле запроса, и в заголовке x-session-id, приоритет у значения из тела. Не длиннее 256 знаков.

Пример: "session-1234"

Служебные сведения для прослеживания запроса. Известные ключи (trace_id, trace_name, span_name, generation_name, parent_span_id) обрабатываются особо. Остальные ключи передаются как ваши дополнительные сведения.

{
  "trace_id": "trace-abc123",
  "trace_name": "my-app-trace"
}

Не длиннее 256 знаков.

Ответ

answers
object
required

Ответы. Ключи совпадают с ключами questions.

model
string
required

Снимок модели, который обслужил запрос. Может быть подробнее запрошенного идентификатора: у линейки появляется датированный суффикс.

usage
object
required

input_tokens — токены входа. output_tokens — токены выхода, в цену не входят. cost — стоимость этого ответа в рублях.

id
string

Идентификатор вызова.

provider
string

Поставщик, который выполнил запрос.