# API 文档

## 流式 API

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

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

- **V2 API**：基于V1基础构建的增强流式接口，具有以下特性：
  - 针对情绪和关系等额外标注的高级检索能力
  - 增强对不同下游应用的支持
  - 改进的插值记忆管理

- **V3 API**：采用完全不同的双时间线同步检索策略的革命性流式接口：
  - 显著提高关键词动作触发率
  - 高级混合能力和改进的过渡效果
  - 双时间线架构，增强动作同步

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

## 请求/响应格式

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

- **分块处理**：语音输入分块处理，实现实时响应
- **动作时间线**：基于帧的时间线管理，实现精确的动作序列
- **关键词匹配**：动作关键词和语音关键词的智能选择
- **记忆集成**：用户会话记忆，避免重复动画