文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>腾讯会议>开放平台文档>服务端 API>REST API 参考>录制管理>智能录制管理>智能发言人

智能发言人

最近更新时间：2025-10-15 19:35:52

我的收藏

本页目录：

接口描述

描述：
查询单个云录制的智能发言人列表，支持 OAuth 2.0鉴权调用，仅支持授权用户为商业版、企业版、教育版。
当该录制文件未开启相关智能化功能或内容处于生成中状态时，不支持调用。
依赖权限点：
自建应用：具备管理企业录制和查看企业录制权限。
三方应用：具备查看您的录制和查看和管理您的录制权限。
Operator 用户角色：勾选账户管理 > 录制管理 > 查看权限。可前往用户管理 > 角色管理页面设置。
请求方法：GET
接口请求域名：
https://api.meeting.qq.com/v1/smart/speakers


输入参数

查询参数

以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必填
参数类型
参数描述
operator_id
是
String
操作者 ID。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值，operator_id 代表不同类型。
operator_id_type
是
Integer
操作者 ID 类型：
1：userid
2：openid
record_file_id
是
String
录制文件 ID，录制列表接口会返回该 ID。
pwd
否
String
录制文件的访问密码，非必填。
page
是
Integer
页码，从 1 开始。
page_size
是
Integer
返回数量，最大 50。

输出参数

参数名称
参数类型
参数描述
total_count
Integer
发言人总数。
speaker_list
录制文件的智能发言人列表。

SpeakerList 对象

参数名称
参数类型
参数描述
speaker_id_type
Integer
发言人ID类型：
1：userid
2：openid
6：temp_id（临时 ID）
说明：自行上传的录制文件无法解析映射出 userid 或识别为企业外用户，将赋予 temp_id 作为唯一用户标识
speaker_id
String
发言人 ID。speaker_id 必须与 speaker_id_type 配合使用；
根据 speaker_id_type 的值不同，speaker_id 分别为 userid、openid 或 temp_id 的映射。
speaker_name
String
发言人名称，返回 Base64编码后的结果。
total_time
Integer
发言总时长，单位毫秒。
speaker_time
录制文件某个具体发言人的发言时间段，以对象数组形式返回。
ms_open_id
String
会议中为每个参会成员授予的临时 ID，表示同一场会议内用户的唯一标识，不同会议间 ms_open_id 隔离，返回 Base64编码后的结果。

SpeakerTime 对象

参数名称
参数类型
参数描述
sid
String
发言语句 ID。
start_time
String
发言开始时间，单位毫秒。
end_time
String
发言结束时间，单位毫秒。

示例

输入示例

https://api.meeting.qq.com/v1/smart/speakers?record_file_id=178xxxxxxxxx281&operator_id_type=1&operator_id=xxxxx&page_size=50&page=1

输出示例

{
    "speaker_list": [
        {
            "speaker_id": "xxxxxxxx",
            "speaker_id_type": 6,
            "speaker_name": "Ym9iZ2xxxxxxxxxxxxxazoik=",
            "total_time": 96180,
            "speaker_time": [
                {
                    "start_time": "7339",
                    "end_time": "23719",
                    "sid": "0"
                },
                {
                    "start_time": "111759",
                    "end_time": "112419",
                    "sid": "6"
                },
                {
                    "start_time": "206939",
                    "end_time": "274169",
                    "sid": "7"
                },
                {
                    "start_time": "295079",
                    "end_time": "307559",
                    "sid": "23"
                },
                {
                    "start_time": "329399",
                    "end_time": "371089",
                    "sid": "26"
                },
                {
                    "start_time": "384019",
                    "end_time": "447519",
                    "sid": "35"
                },
                {
                    "start_time": "490979",
                    "end_time": "494199",
                    "sid": "45"
                }
            ],
            "ms_open_id": "MYDTv1+3mm65"
        }
    ],
    "total_count": 1
}


中国站
目录