Neocortex Logo

Web API

Вызов персонажей из любого движка

Web API Neocortex позволяет любому движку, языку или платформе общаться с персонажами, созданными в редакторе, по обычному HTTP. Всё, что делают SDK Neocortex, проходит через те же эндпоинты, поэтому собственный движок, игровой сервер или бэкенд-инструмент получают ровно тех же персонажей, что и проект на SDK. Отправьте id персонажа и сообщение игрока, и ответ придёт в виде структурированных данных, с которыми игра сразу может работать.

Web API: возможности

Web API подходит для движков без SDK, для серверов и для всего остального, что умеет отправлять HTTPS-запросы.

Три ключевые возможности и преимущества

Один базовый URL обслуживает чат, групповой чат, историю разговоров, синтез речи, потоковую речь и распознавание речи, а аутентификация идёт по API-ключу, привязанному к вашей команде. Другие преимущества:

  • Ответы приходят структурированными данными, а не сплошным текстом: от одной до трёх реплик, у каждой своя эмоция, игровые действия, которые выбрал персонаж, с id целевого объекта для каждого из них, и контрольная точка сценария диалога, до которой дошёл ход.

  • Игра может сообщать персонажу, что он воспринимает и что только что произошло: до 40 сущностей и 20 событий на запрос. Данные о мире всегда обрабатываются как данные и никогда как инструкции.

  • Эндпоинт использования показывает расход по каждому игроку и каждому персонажу относительно лимитов, заданных в панели, так что игра может узнать о превышении лимита ещё до запроса.

Для браузерных игр Web SDK добавляет небольшой серверный прокси, который хранит API-ключ на вашем сервере, так что браузер его никогда не видит.