Neocortex Logo

Web API

Llama a personajes desde cualquier motor

La Web API de Neocortex permite que cualquier motor, lenguaje o plataforma hable por HTTP estándar con los personajes que creas en el editor. Todo lo que hacen los SDK de Neocortex pasa por los mismos endpoints, así que un motor propio, un servidor de juego o una herramienta de backend obtiene exactamente los mismos personajes que un proyecto con SDK. Envía el id de un personaje y el mensaje del jugador, y la respuesta llega como datos estructurados con los que tu juego puede actuar.

Web API: funciones

La Web API es la vía para motores sin SDK, para servidores y para cualquier cosa capaz de hacer una petición HTTPS.

Tres funciones clave y sus ventajas

Una única URL base sirve el chat, el chat grupal, el historial de conversaciones, la conversión de texto a voz, la voz en streaming y la conversión de voz a texto, con autenticación mediante una clave de API asociada a tu equipo. Otras ventajas:

  • Las respuestas son datos estructurados, no un bloque de texto: de una a tres frases, cada una con su emoción; las acciones de juego que eligió el personaje, con el id del objeto al que apunta cada una; y el punto de control del Flujo de conversación al que llegó el turno.

  • Tu juego puede contarle a un personaje lo que percibe y lo que acaba de pasar, con hasta 40 entidades y 20 eventos por petición. Los datos del mundo se tratan siempre como datos, nunca como instrucciones.

  • Un endpoint de uso informa del consumo por jugador y por personaje frente a los límites que fijas en el panel, para que tu juego sepa si un jugador ha superado un límite antes de hacer la llamada.

Para juegos de navegador, el Web SDK añade un pequeño proxy de servidor que mantiene tu clave de API en tu servidor, así el navegador nunca la ve.