跳至正文

Spatius 产品更新:Avatar API、更高效的音频传输与生产级 SDK

过去几周,Spatius 在三个直接影响数字人从 Demo 进入正式产品的方向上持续演进:自动化、网络效率和生产运维。

已加入 Spatius API 私测的团队可以通过 API 以编程方式创建和管理 Avatar。AvatarKit 1.3 为多个客户端平台带来了更高效的音频传输、自动区域选择和更明确的播放控制。最新的 @spatius/avatarkit-rtc Package 兼容文档规定的 livekit-client peer range,Spatius Motion Server 现在会向 LiveKit Room 发布更高质量的音频。Spatius Plugin 现已在官方 LiveKit Agents 仓库中维护,并默认使用 Ogg Opus。

核心更新

  • Spatius API 私测 可为已获准的团队从图片 URL 创建 Avatar、查询异步任务状态,以及列出或读取生成后的 Avatar 资源。
  • AvatarKit 1.3 让音频传输更高效、区域选择更简单,并改善多个客户端平台的播放体验。
  • Python SDK 1.0.5 让服务端集成更容易配置,也更灵活易用。
  • Spatius Plugin 的维护地址是 livekit/agents monorepo,1.7.0 版本于 8 月 20 日发布。
  • 最新 @spatius/avatarkit-rtc Package 已兼容最新版本的 livekit-client;原生端与 Web RTC Adapter,以及覆盖 Web、Android 和 iOS 的新场景 Demo,让团队可以更容易地跨端验证同一套数字人体验。

发布时间概览

日期发布项主要变化
7 月 25 日Spatius API 文档以编程方式创建、读取和列出 Avatar,并查询异步创建任务
8 月 7 日AvatarKit iOS 1.3.3更高效的音频、更简单的区域选择和更顺畅的播放
8 月 10 日LiveKit Agents Plugin 更新Spatius Plugin 默认音频格式改为 Ogg Opus
8 月 16 日Python SDK 1.0.5更简单的配置和更灵活的服务端音频处理
8 月 17 日客户端与 RTC 版本Web AvatarKit 1.3.7、兼容 livekit-client ^2.15.9 的 Web RTC Adapter 1.1.3,以及稳定版 iOS RTC Adapter
8 月 20 日LiveKit Agents 1.7.0维护中的 Spatius Plugin 随 LiveKit Agents 1.7 系列发布

发布日期可以确认某个包或文档能力何时公开,但不代表所有 SDK 的 API 完全一致。比较 Web、iOS、Android、Flutter、Python 和 Go 时,请以当前的 SDK 能力矩阵为准。

通过 API 创建和管理 Avatar

这轮更新中最直观的平台能力,是面向 Avatar 资源的私测 API。当前只有已获准的团队可以访问;过去,团队通常把自定义 Avatar 创建视为 Studio 中的操作流程。新接口让这套流程可以在获准的集成中自动化。

应用现在可以:

  1. POST /v1/open/avatars 提交一个公开的 JPEG 或 PNG URL。
  2. 获得状态为 queued 的创建任务。
  3. 轮询 GET /avatar-jobs/{jobId},直到任务成功或失败。
  4. 在任何接受 Avatar ID 的 Spatius SDK 集成中使用返回的 avatarId
  5. 为内部运营工具列出和读取 Avatar 与创建任务。

完整请求结构见 Create an Avatar 接口,可重试和不可重试错误见 API 错误与限制

这项能力让获准团队的产品边界更实用。客服平台可以在 API 权限获批后于租户入驻时创建品牌 Avatar;学习产品可以从经过审核的素材流程中准备教师角色;内部运营工具可以展示任务状态,而不要求操作人员切换到 Studio。API 并不取代 Studio,而是让同一个 Avatar 资源进入获准的自动化工作流。

AvatarKit 1.3 让实时体验更顺畅

AvatarKit 1.3 带来了一组贴近日常使用的改进:音频传输更高效,自动区域选择减少了配置工作,新的播放控制也让语音与动作更容易在 Web、iOS、Android 和 Flutter 上保持同步。

对于 iOS 团队,AvatarKit 1.3.3 重点改善了播放流畅度、连接可靠性和 RTC 集成体验。这里不逐项展开底层变化,完整修复列表和迁移说明请以 AvatarKit iOS 1.3.3 Release Notes为准。对路由或数据驻留有明确要求的团队,也可以查看区域参考

服务端 SDK 更容易用于生产环境

最新的 Backend Mode 版本让服务端集成更简单、更可靠。Python SDK 1.0.5简化了自动区域设置,增加了启动 Session 时的灵活性,并支持更多音频工作流。

Go SDK 1.0.3重点改善了音频处理的可靠性和质量。完整变化与升级细节请以链接中的 Release Notes 为准。

LiveKit Plugin 现在与 LiveKit Agents 一起维护

Spatius Plugin 现在与 Agent Framework 一起维护在官方 livekit/agents 仓库中。可安装的 Package Name 仍然是 livekit-plugins-spatius

迁移之后,Plugin 默认使用更高效的音频方式,与最新的 Spatius 服务端 SDK 保持一致,并随 LiveKit Agents 1.7.0 发布。完整版本历史请查看 LiveKit Agents 1.7.0 Release Notes

对已经使用 LiveKit 的团队来说,产品边界仍然清晰:LiveKit 管理语音 Agent 和 Room,Spatius 提供 Avatar 的动作与视觉体验。LiveKit Agents 集成指南介绍了完整接入流程。

Spatius Motion Server 现在会向 LiveKit Room 发布更高质量的音频。这样,连接到 Room 的参与者可以听到更清晰的音频,同时客户端仍然根据 Room 中的 Motion data 在本地渲染 Avatar。

RTC Adapter 与 Demo 更容易验证

Web Package 在 8 月继续更新。@spatius/avatarkit 于 8 月 17 日更新到 1.3.7,@spatius/avatarkit-rtc 更新到 1.1.3。最新 @spatius/avatarkit-rtc Package 已兼容最新版本的 livekit-client;当前 Package 组合使用 livekit-client ^2.15.9。使用 LiveKit 的团队可以更轻松地让 Web 集成保持最新。

同一天,iOS RTC Adapter 发布稳定版 1.0.0,让团队可以在 iOS 上更轻松地提供一致的 Room 数字人体验,并获得更顺畅的播放与过渡效果。

新的 AvatarKit Scenes Demo通过完整场景,而不是孤立 API 调用,展示了产品边界。仓库包含四个场景的 Web、Android 和 iOS 实现:

  • 一对一教学;
  • 带聊天和观众互动的直播;
  • 包含主题、搜索、卡片和语音的银行客服;
  • 带持久化 Persona 的陪伴体验。

共享后端既可以运行本地 LiveKit Agent,也可以使用 Agora Conversational AI。因此,团队可以在不为每个客户端重新设计产品体验的前提下比较不同传输路径。

升级检查清单

对现有集成来说,应把这轮更新视为一次可控的 Runtime 升级,而不只是修改 Package Version。

  1. 先确认当前使用的集成路径:Direct Mode、Backend Mode、LiveKit Agents 或 Agora Conversational AI。
  2. 阅读计划升级的每个 SDK 的 Release Notes。兼容性和迁移细节应以 Release Notes 为准。
  3. 每次只升级一个客户端平台,并在用户常用的设备和网络上测试语音、动作、打断与重连。
  4. 根据数据驻留和路由要求验证自动区域选择。
  5. LiveKit 集成应同时升级 @spatius/avatarkit-rtclivekit-client,并以官方 livekit/agents 仓库中的 Plugin 为准。

保持不变的产品边界

Spatius 仍然是实时视觉层,而不是打包式对话 Stack。你的应用、Agent Framework 或后端仍然拥有 ASR、LLM、TTS、Prompt、工具、权限、对话策略和人工转接。Spatius 接收 Avatar 应该说出的音频,生成 Motion data,并由 AvatarKit 在本地渲染结果。

这个稳定边界把本轮更新连接在一起:新 API 自动化 Avatar 资源;Opus 与自动区域改善传输;更新后的 RTC Package 让 Web 集成更容易保持最新;LiveKit 集成把同一视觉层放入 Agent 和 Room 架构,而不会接管这些系统。

常见问题

Spatius Plugin 在哪里维护?

它位于官方 livekit/agents monorepo 的 livekit-plugins/livekit-plugins-spatius 目录。安装包名称仍然是 livekit-plugins-spatius。

新的 Avatar API 会取代 Spatius Studio 吗?

不会。API 为创建、列出和读取同一类 Avatar 资源增加了编程入口,Studio 仍然是可视化管理界面。

AvatarKit 1.3 是否要求所有应用都使用 Opus?

不要求。AvatarKit 1.3 提供了更高效的音频路径,但团队可以根据现有集成安排升级。各平台的具体行为请以对应的 Release Notes 为准。

Spatius 现在是否提供 LLM、TTS 和 Agent 工具?

不提供。Spatius 仍然是 Avatar 展示层。推理、语音生成、工具、权限和对话策略仍由应用或 Agent Framework 负责。

查看最新 SDK 参考 打开 Spatius Studio, or ,或阅读开发者文档, or ,或体验 Playground.

延伸阅读

让你的智能体拥有一张会回应的脸。

开始构建