给 AI 装上「身体」：我用魔珐星云做数字人的实践与接入教程

一篇个人使用记录 + 完整 SDK 接入教程。前半是我为什么用、怎么用；后半是给开发者的照做即可的接入步骤。

官网：www.xingyun3d.com/

新用户福利 ：新用户注册可以填写魔珐星云的邀请码： 【JMBAY7Y65P】 ，可免费获取1000积分，体验数字人2000分钟！

一、最近在玩魔珐星云

这段时间我一直在折腾 魔珐星云，一个 3D 数字人开放平台。

它和常见的「会说话的头像」不一样：你给一段文字，它生成的不只是语音，还有配套的表情和动作，出来的是一个会动、会说话的 3D 数字人------不是图片，也不是提前录好的视频。用官方的说法叫「具身智能」，通俗点讲，就是给原本只有「脑子」的 AI 补上了「身体」和「表达能力」。

真正打动我的是它开放 SDK：不只是在平台里生成成品，而是能把数字人能力直接嵌进自己的网页、应用里，跟自己的业务和大模型接起来。这就从「做视频的工具」变成了「能长在产品里的一块能力」。

二、我的实际应用

说明：以下是我自己的落地场景，供参考。你可以替换成你真实的项目。

我平时做内容和小程序，一直想给用户一个「有人味」的交互入口，而不是冷冰冰的对话框。魔珐星云正好补上了这一块，我主要用在三个地方：

1. 内容创作：口播视频提效

以前一条口播视频要写稿、出镜、拍摄、剪辑，一个人跑下来很累。现在稿子写好，直接交给数字人播报出片，形象和声音统一，产量明显上来了。对于需要稳定更新的公众号 / 短视频内容，这个提效是实打实的。

2. 小程序 / 网页：交互式虚拟形象

我把数字人嵌进页面里，当作一个会说话、会做表情的「导览 / 客服」角色。用户进来不再是面对一个输入框，而是有个形象跟他打招呼、答疑、引导操作。信任感和停留时长都比纯文字界面要好。

3. 接大模型：能对话的数字人

这是我觉得最有想象力的一步------把数字人和大模型接起来：用户提问 → 大模型生成回答 → 数字人把回答播报出来。于是它不再是「按剧本念稿」，而是能根据用户的问题实时应答。医疗导诊、商场导览、景区讲解这类场景，都能套这个链路。

一句实在话：它不是万能的，复杂场景仍然需要调；但作为「日常内容生产 + 给产品加一个虚拟人」的方案，性价比和上手门槛都在我可接受的范围内。所以顺手把接入过程整理成下面这份教程，方便想试的朋友直接照做。

三、SDK 接入教程

3.0 整体调用链路

接入逻辑很简单，核心就是把「文本」送进数字人 SDK 让它播报；接了大模型之后，再把模型的回答喂给播报方法。

text 复制代码

创建驱动应用
    ↓
获取 appId / appSecret / gatewayServer
    ↓
项目中配置参数
    ↓
初始化 XmovAvatar
    ↓
调用 speak 播报文本
    ↓
（可选）接入大模型，将模型回答传给 speak

3.1 准备工作

注册并登录

打开官网 www.xingyun3d.com/ ，点击右上角 登录 / 注册。
注册时填写邀请码，完成账号绑定。

⚠️ 注意：邀请码不要填错，也不要多复制空格，否则绑定失败。

确认账号权益

登录后点击右上角头像进入个人中心，确认账号已具备 SDK 体验额度。可在以下位置核对权益是否生效：

消耗记录
订单发票

确认账号具备 SDK 体验额度后，再继续创建应用，避免走到一半没额度。

3.2 创建驱动应用并获取配置

创建驱动应用，进入平台左侧菜单：

text 复制代码

应用管理 → 驱动应用 → 创建驱动应用

按页面提示填写应用名称等基础信息，完成创建。

选择数字人形象：创建完成后进入应用详情页，选择对应数字人形象并保存。

获取调用配置：进入已创建的驱动应用，复制 SDK 调用所需的两项配置：

text 复制代码

appId
appSecret

3.3 在项目里接入 SDK

① 配置参数

javascript 复制代码

const xingyunConfig = {
  appId: '替换为自己的 appId',
  appSecret: '替换为自己的 appSecret'
}

② 准备挂载容器

html 复制代码

<div id="avatar-container"></div>

③ 初始化 SDK

javascript 复制代码

const avatar = new XmovAvatar({
  containerId: '#avatar-container',
  appId: xingyunConfig.appId,
  appSecret: xingyunConfig.appSecret,
  gatewayServer: 'https://nebula-agent.xingyun3d.com/user/v1/ttsa/session'
})

④ 调用播报

javascript 复制代码

avatar.speak('你好，我是魔珐星云数字人。')

建议封装一层，统一做防空判断：

javascript 复制代码

function speakText(text) {
  if (!avatar) {
    console.warn('SDK 未初始化')
    return
  }
  if (!text) {
    console.warn('播报文本为空')
    return
  }
  avatar.speak(text)
}

实际项目中，播报方法名以当前 SDK 版本或项目封装为准。

3.4 接入大模型问答（可选）

text 复制代码

用户输入问题
    ↓
请求大模型接口
    ↓
获取大模型返回文本
    ↓
调用数字人 SDK 播报文本

javascript 复制代码

async function handleQuestion(question) {
  const answer = await callLLM(question)  // callLLM 由项目自行实现
  speakText(answer)
}

callLLM 由项目自行实现，可接入豆包、OpenAI 兼容接口或其他大模型服务。

3.5 体验与测试

⚠️ 建议体验 2 分钟以上，充分感受语音、表情、动作效果。

依次尝试以下输入（每次等数字人回复后再继续）：

输入：你好
输入以下任一，等待回复：这里有什么好玩 / 这里有什么好吃的 / 我的症状是发热
输入以下任一，等待回复：我想去发热科室 / 我想去电影院 / 我想去某某商家

测试顺序建议：

① 基础播报测试 --- 输入 你好，判断：数字人是否正常加载、能否语音播报、嘴型/动作是否正常、页面是否报错。
② 场景问答测试 --- 输入 这里有什么好玩的？ 或 我的症状是发热。，判断：大模型是否返回内容、数字人能否播报返回内容、连续多轮输入是否正常。

四、几点注意事项

配置隔离：appId / appSecret 是账号 + 应用级别的，不要跨账号混用，也不要写死在可被公开访问的前端代码里（有安全要求时，敏感配置建议走后端代理）。
体验额度：先确认账号权益生效再开发，避免卡在调用环节。
接口名 ：speak、XmovAvatar 等以当前 SDK 版本为准，升级后留意变更。
效果预期：简单播报开箱即用，复杂交互场景仍需按业务调优。

五、写在最后

用下来的整体感受：它把「让 AI 拥有身体」这件原本很重的事，做成了普通开发者也能上手的能力。如果你也在做内容生产，或想在自己的产品里加一个能对话、有表情的虚拟形象，值得亲手试一次------那种「AI 活过来了」的感觉，文字确实形容不出来。

官网在这，感兴趣自己看看：www.xingyun3d.com/

新用户福利 ：新用户注册可以填写魔珐星云的邀请码： 【JMBAY7Y65P】 ，可免费获取1000积分，体验数字人2000分钟！

（本文接入部分整理自官方「星云平台 SDK 操作教程」，界面与接口以平台最新版本为准。）