API 文档

API 文档#

流式 API#

系统提供三个版本的流式 API，具有不同的功能和部署策略：

  • V1 API：基础流式动作生成接口，具有基本动作关键词匹配功能。该版本目前已弃用，不再维护。

  • V2 API：基于V1基础构建的增强流式接口，具有以下特性：

    • 针对情绪和关系等额外标注的高级检索能力

    • 增强对不同下游应用的支持

    • 改进的插值记忆管理

  • V3 API：采用完全不同的双时间线同步检索策略的革命性流式接口：

    • 显著提高关键词动作触发率

    • 高级混合能力和改进的过渡效果

    • 双时间线架构，增强动作同步

部署：V2 和 V3 API 同时部署，可通过不同的 FastAPI 服务端点访问，允许应用程序根据特定需求选择最合适的版本。

请求/响应格式#

所有 API 都使用 Protocol Buffers 进行高效序列化。系统支持：

  • 分块处理：语音输入分块处理，实现实时响应

  • 动作时间线：基于帧的时间线管理，实现精确的动作序列

  • 关键词匹配：动作关键词和语音关键词的智能选择

  • 记忆集成：用户会话记忆，避免重复动画

Contents