Web API
Charaktere aus jeder Engine aufrufen
Mit der Neocortex Web API spricht jede Engine, jede Programmiersprache und jede Plattform per einfachem HTTP mit den Charakteren, die du im Editor baust. Alles, was die Neocortex SDKs tun, läuft über dieselben Endpoints. Eine eigene Engine, ein Spielserver oder ein Backend-Tool bekommt also genau dieselben Charaktere wie ein SDK-Projekt. Schick eine Charakter-ID und die Nachricht des Spielers, und die Antwort kommt als strukturierte Daten zurück, auf die dein Spiel reagieren kann.
Web API im Überblick
Die Web API ist der Weg für Engines ohne SDK, für Server und für alles andere, was eine HTTPS-Anfrage stellen kann.
Drei zentrale Funktionen und ihre Vorteile
Eine einzige Basis-URL liefert Chat, Gruppenchat, Gesprächsverlauf, Text-to-Speech, gestreamte Sprachausgabe und Speech-to-Text, authentifiziert über einen API-Schlüssel, der an dein Team gebunden ist. Weitere Vorteile:
Antworten sind strukturierte Daten statt eines Fließtextblocks: ein bis drei Zeilen, jeweils mit einer Emotion versehen, die Aktionen im Spiel, die der Charakter gewählt hat, jeweils mit der ID des Zielobjekts, und der Checkpoint im Gesprächsfluss, den die Runde erreicht hat.
Dein Spiel kann einem Charakter mitteilen, was er wahrnimmt und was gerade passiert ist, mit bis zu 40 Entitäten und 20 Ereignissen pro Anfrage. Weltdaten werden immer als Daten behandelt, nie als Anweisungen.
Ein Usage-Endpoint meldet die Nutzung pro Spieler und pro Charakter im Verhältnis zu den Limits, die du im Dashboard festlegst. So weiß dein Spiel schon vor dem Aufruf, ob ein Spieler über einem Limit liegt.
Für Browserspiele bringt das Web SDK einen kleinen Server-Proxy mit, der deinen API-Schlüssel auf deinem Server hält, sodass der Browser ihn nie zu sehen bekommt.