一行代码嵌入，
或者完全接管整条链路

# 1. 创建一次数字人会话
curl -X POST https://api.zhiyu-ai.example.com/v1/sessions \
  -H "Authorization: Bearer $ZHIYU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "app_id": "app_demo_001",
    "agent_id": "agt_xingyao",
    "avatar_id": "avt_xingyao_2d",
    "ttl_seconds": 600,
    "metadata": { "channel": "web", "user_tier": "gold" }
  }'

# 2. 下发一轮文本对话，返回合成音频与口型驱动数据
curl -X POST https://api.zhiyu-ai.example.com/v1/sessions/$SID/turns \
  -H "Authorization: Bearer $ZHIYU_API_KEY" \
  -d '{"input": {"type": "text", "text": "帮我查一下上个月的账单"}}'

# 3. 结束会话，回收算力
curl -X DELETE https://api.zhiyu-ai.example.com/v1/sessions/$SID

import { ZhiyuDigitalHuman } from '@zhiyu/digital-human-sdk';

const dh = new ZhiyuDigitalHuman({
  apiKey: process.env.ZHIYU_API_KEY,
  avatarId: 'avt_xingyao_2d',
  container: '#stage',
  resolution: '1080p',
  fps: 30,
});

await dh.ready();

// 1) 音频驱动：传入任意 PCM / MP3 音频流
dh.driveByAudio(audioStream);

// 2) 文本驱动：由平台内置 TTS 合成并驱动
dh.speak('您好，欢迎来到云启银行。', {
  speaker: 'spk_xingyao',
  emotion: 'gentle',
  speed: 1.0,
});

// 3) 打断：立即停止当前播报并转入聆听
dh.interrupt();

// 4) 实时事件
dh.on('audience:speaking', () => console.log('用户开始说话，已打断'));
dh.on('lip:sync', (m) => console.log('唇形误差(ms):', m.latency));

// Android 一体机示例
val client = ZhiyuClient.Builder()
    .appId("app_demo_001")
    .agentId("agt_xingyao")
    .avatarId("avt_xingyao_3d")
    .audioMode(AudioMode.FULL_DUPLEX)      // 全双工，支持打断
    .enableVad(true)
    .build()

client.attach(stageView)                       // 绑定渲染视图
client.onEvent { event ->
    when (event) {
        is ZhiyuEvent.Ready       -> client.speak(welcomeText)
        is ZhiyuEvent.IntentHit   -> trackAnalytics(event.intent, event.confidence)
        is ZhiyuEvent.NeedHuman  -> transferToDesk()
    }
}