Основное 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 знаков.
Ответ
Ответы. Ключи совпадают с ключами questions.
Снимок модели, который обслужил запрос. Может быть подробнее запрошенного идентификатора: у линейки появляется датированный суффикс.
input_tokens — токены входа. output_tokens — токены выхода, в цену не входят. cost — стоимость этого ответа в рублях.
Идентификатор вызова.
Поставщик, который выполнил запрос.