Neocortex Logo

Web API

从任意引擎调用角色

Neocortex Web API 让任何引擎、语言或平台都能通过普通 HTTP,与你在编辑器中打造的角色对话。Neocortex SDK 的所有功能都通过同一组接口实现,因此自研引擎、游戏服务器或后端工具拿到的角色,与 SDK 项目中的完全一样。发送角色 id 和玩家消息,回复就会以结构化数据的形式返回,游戏可以直接据此行动。

Web API 功能

没有 SDK 的引擎、服务器,以及任何能发起 HTTPS 请求的程序,都可以通过 Web API 接入。

三大核心功能与优势

一个基础 URL 即可提供聊天、群聊、对话历史、文本转语音、流式语音和语音转文本服务,并使用限定于你团队的 API 密钥进行认证。其他优势包括:

  • 回复是结构化数据,而不是一大段文字:一到三句台词,每句都标有情绪;角色选择的游戏内动作,以及每个动作所针对物体的 id;还有本回合到达的对话流程检查点。

  • 游戏可以告诉角色它感知到了什么、刚刚发生了什么,每次请求最多 40 个实体和 20 个事件。世界数据始终被当作数据处理,绝不会被当作指令。

  • 用量接口会按玩家和角色报告用量,并对照你在控制台中设置的上限,让游戏在调用之前就知道某位玩家是否已超出限制。

对于浏览器游戏,Web SDK 提供一个小型服务器代理,把 API 密钥保留在你的服务器上,浏览器永远看不到它。