FIGOMOSS / 产品指南
数字人 API 怎么接入？语音、知识与口型能力的组合方式
FigoMoss 开放平台为已有软件提供经授权的数字人能力接口。开发者既可单独调用语音、知识检索和数字人会话，也可使用绑定形象、声音、人设与知识库的已发布应用。
独立能力与完整应用如何选择？
如果已有聊天引擎和语音链路，可以按需接入口型呈现或声音合成；如果希望使用平台的人设与知识问答流程，则应创建应用，绑定需要的资产，检查并发布版本。
资产授权与应用授权应按实际业务需要设置。一个空间有某项资产，不代表所有密钥自动拥有调用权；应用也应引用已确认的声音、形象与知识版本。
浏览器和服务端分别放什么凭证？
平台密钥应保存在客户服务端，不应放进网页脚本、移动端安装包或公开仓库。浏览器场景通过受限的临时凭证接入，按允许的来源与资产范围建立会话。
上线前需要分别验证正常调用、权限不足、额度不足、断开重连和错误处理。不要仅以接口返回成功判断音频和视频已在用户设备上正确呈现。
一次集成通常包含哪些环节？
先创建工作空间并准备资产或应用，再在开放平台申请合适范围的密钥，按照当前接口文档完成服务端调用与前端呈现。平台提供 API、JavaScript SDK 与接入示例；具体端点与参数以开放平台文档为准。
- 确认需要的能力、资产授权与应用版本。
- 测试文字回复、音频播放和口型呈现，不把三者视为同一个成功状态。
- 处理闲置会话释放、错误降级、可用额度和调用记录。
- 需要制作新数字人时走工作台制作流程，不把会话接口误作自动训练接口。
关于数字人 API的常见问题
如何把数字人接入自己的网站或软件？
官网接待可通过网站 Widget 嵌入；已有软件可通过开放平台 API 与 JavaScript SDK 接入。服务端保存平台密钥，浏览器使用临时凭证，按授权范围调用资产、语音、知识、对话和数字人会话。
开放平台是否意味着任意用户都能读取所有数字人资料？
不是。API 调用受空间、密钥、应用及资产授权约束。公开产品介绍不包含私人资料、密钥或未授权的角色知识库。
把资料与能力用在自己的业务里
创建工作空间，准备已获授权的素材和业务知识，再选择工作台、网站 Widget 或开放平台接入。套餐、额度和实际可用功能以工作台为准。