DOCS
接入文档
把 AI 数字人嵌入你的网站，3 种方式任选，最少 2 行代码即可上线。完整参数与错误码请进入控制台查看。
三步快速接入
1创建数字人
登录控制台 → 新建数字人，选择形象与音色，得到 Agent ID。
2生成 API 密钥
创建时自动生成一把默认 Key；也可为不同站点单独创建带域名白名单的 Key。
3复制代码嵌入
在控制台「接入文档」页复制完整代码片段，替换占位即可上线。
三种方式怎么选
先看这张对比表，再挑最适合自己的方式。
| 方式 | 适用场景 | 可控性 | 样式隔离 |
|---|---|---|---|
| JS SDK | 单页应用、需要事件订阅与程序化控制 | ★★★ | 中 |
| Web Component | Vue / React / 原生 HTML，要求简洁 | ★★ | 高（Shadow DOM） |
| iframe | 静态网页、CMS、文章、零依赖 | ★ | 最高（沙箱） |
选哪条接入路线?
看你的 LLM 输出什么 —— 只出文本走 A,自带音频走 B。
A · 文本
你的 LLM 出文本 —— 我们做 TTS + 口型
把文本传给我们,音色合成和数字人口型都由我们处理。最快路径:几行真代码就能跑通。
首次接入推荐
B · 音频
你的 LLM 出文本 + 音频 —— 我们只做口型
你自带 TTS 出音频,我们只负责对口型。适合需要自家音色 / 明星 IP / 品牌音 / 方言的场景。
适合品牌定制音色
推荐先 A 上线,后面想换 B 不用改架构 —— 同一个 widget 实例换 API 即可。
最快上手 · SDK 示例
复制下面的代码,把 agent_xxx 和 YOUR_API_KEY 换成自己的就能跑。
JS SDK · HTML
<script type="module" src="https://embed.avataraisdk.com/sdk.js"></script>
<script type="module">
const widget = AIAvatar.init({
agentId: 'agent_xxxxxxxxxxxx',
apiKey: 'YOUR_API_KEY',
behavior: { llmMode: 'external' },
// 路线 A:你的 LLM 出文本,我们做 TTS + 口型
onUserInput: async (msg) => {
const reply = await myCustomerLLM(msg.content);
widget.replyText(reply);
},
});
</script>JS SDK / Web Component 接入方式、参数详解、错误码、域名白名单等完整文档都在控制台。