获取 WebSocket 驱动信息

2026-08-03

描述

通过本接口，您可以获取一个 WebSocket 链接地址。通过向这个地址传输 PCM 音频数据以实时驱动数字人说话。通过 WebSocket 驱动方式可以实现灵活调用第三方 TTS 厂商驱动数字人。如果您已经接入了第三方 TTS 厂商，或者有比较倾向的厂商，推荐您使用此方案驱动数字人。

本接口支持传入单声道和双声道 PCM 音频数据。当传入双声道音频时，可在 WebSocket Start 指令中通过 Channel 参数指定音频声道数，并通过 VoiceChannel 参数指定人声所在声道位置，系统将自动从对应声道提取人声进行驱动。

如需了解使用 WebSocket 驱动数字人的完整流程，请参考实现数字人 AI 互动对话。

说明

当使用 Websocket 音频流驱动数字人时，数字人会默认正在进行的播报任务，并丢弃正在排队中的播报任务。

接口原型

请求方法：POST
请求体格式：JSON
请求地址：https://aigc-digitalhuman-api.zegotech.cn?Action=DriveByWsStream
传输协议：HTTPS
调用频率限制：10 次/秒

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表请参考调用方式 - 公共请求参数。

参数	类型	是否必填	描述
TaskId	String	是	数字人视频流任务 ID。通过创建数字人视频流任务接口的响应参数获取。

请求示例

请求地址 URL：

https://aigc-digitalhuman-api.zegotech.cn?Action=DriveByWsStream
&<公共请求参数>

https://aigc-digitalhuman-api.zegotech.cn?Action=DriveByWsStream
&<公共请求参数>

请求消息体：

{
    "TaskId": "c54ffce5-e63c-414f-9342-b0777ae8e691"
}

{
    "TaskId": "c54ffce5-e63c-414f-9342-b0777ae8e691"
}

响应参数

参数	类型	描述
Code	Number	返回码。0 表示成功，其他值表示失败。如需了解错误码及响应处理建议，请参考返回码。
Message	String	请求结果的说明信息。
RequestId	String	请求 ID。
└DriveId	String	数字人视频流驱动任务 ID。
└WssAddress	String	数字人视频流任务对应的 WebSocket 连接地址。通过此地址与数字人 API 服务服务端建立连接之后，可以向其传输 PCM 音频数据驱动数字人说话。

响应示例

{
    "Code": 0,
    "Message": "success",
    "RequestId": "9f5228e2-2c90-4faa-aa7e-7ebbf28bbd83",
    "Data": {
        "DriveId": "9b9c09ef-281d-43d8-807f-e00e71049642",
        "WssAddress": "wss://xx.xx.xx.xx:xxx/ws?Token=xxxx"
    }
}

{
    "Code": 0,
    "Message": "success",
    "RequestId": "9f5228e2-2c90-4faa-aa7e-7ebbf28bbd83",
    "Data": {
        "DriveId": "9b9c09ef-281d-43d8-807f-e00e71049642",
        "WssAddress": "wss://xx.xx.xx.xx:xxx/ws?Token=xxxx"
    }
}