跳到主要内容

即构语音流异步接口

1. 接口介绍​

即构客户使用直播语音流服务时，可使用鉴权 Token 授权图普以匿名用户登录房间，拉取语音流进行实时审核。目前图普语音流识别已支持即构合流模式，审核过程中不产生录制费用。业务流程如下：

1.1 接入指南​

  1. 联系客户经理开通账号
  2. 同客户经理沟通详细需求与审核标准。根据您的需求，客户经理将为您开通对应的应用（SID）
  3. 访问控制台 - 数字证书 获取用于接口鉴权的 API Key
  4. 查阅下方的接口参数文档，了解如何构建请求以及如何解析响应数据
  5. 使用 示例资源 调用接口，进行调试和测试
  6. 查阅 审核场景汇总结果说明，了解如何通过汇总结果判断内容是否违规，以及如何解析汇总结果
  7. 添加异常处理逻辑，以处理可能出现的错误和异常情况，增强代码的健壮性和稳定性

如果在接入过程中遇到任何技术问题，请联系客户经理以获取帮助。

1.2 参考文档​

2. 请求​

客户调用图普 语音流识别接口 提交审核任务时， 在扩展参数 customInfo.zego 中指定即构鉴权 Token 及房间 ID 等相关参数，即可识别即构语音流。参数说明如下：

2.1 扩展参数说明​

customInfo.zego

参数名称类型是否必填说明
tokenString是即构鉴权 Token，生成文档参考 音视频流审核鉴权 Token。

提示：
1. 生成 Token 时建议设置有效期不少于 4 小时；
2. 针对不同房间 ID，需要获取新的 Token
roomIdString是即构房间 ID，需避免重复提交同一个房间 ID
enableMixingBoolean是是否开启合流模式，需传入 true

2.2 请求示例​

{
  "stream": {
    "url": "zego:<roomId>",
    "callback": "<callback>",
    "returnPreSpeech": false,
    "callbackRule": "all"
  },
  "tasks": [
    "<taskId>"
  ],
  "customInfo": {
    "zego": {
      "token": "<token>",
      "roomId": "<roomId>",
      "enableMixing": true
    }
  },
  "timestamp": 1685000000,
  "nonce": 1685000000,
  "signature": "<signature>"
}

3. 更新日志​

日期说明
2025-01-03新增接入指南