接口描述
描述:获取云录制转写的详情,包含时间戳、文本等内容。支持 OAuth2.0 鉴权调用,仅支持授权用户为商业版、企业版、教育版。
所需权限点为:查看会议录制(VIEW_VIDEO) 或 管理会议录制(MANAGE_VIDEO)。
请求方式: GET
接口请求域名:
https://api.meeting.qq.com/v1/records/transcripts/details
输入参数
参数名称 | 是否必须 | 参数类型 | 示例 | 参数描述 |
meeting_id | 否 | String | "1111" | 会议 ID,当针对上传类型的录制文件操作时,可不传 meeting_id。 |
record_file_id | 是 | String | "1111" | 录制文件 ID。 |
pid | 否 | String | "11111" | 查询的起始段落 ID。获取 pid 后(含)的段落,默认从0开始。 |
limit | 否 | Integer | 20 | 查询的段落数,默认查询全量数据。 |
operator_id | 是 | String | "rick" | 操作者 ID,仅会议创建者、企业超级管理员或有企业录制管理权限的用户可调用。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。 |
operator_id_type | 是 | Integer | 1 | 操作者 ID 的类型: 1:企业用户 userid 2:open_id 3:rooms 设备 rooms_id |
transcripts_type | 否 | Integer | - | 转写类型,默认是0。 0:原文版 1:智能优化版 |
输出参数
参数名称 | 是否必须 | 参数类型 | 参数描述 |
minutes | 否 | Minutes 对象 | 录制转写对象。 |
more | 是 | Boolean | 如果传入 pid 或 limit 字段,且没有一次完全返回,则为 true;否则为 false。 |
Minutes 对象
参数名称 | 是否必须 | 参数类型 | 参数描述 |
paragraphs | 非必须 | Paragraph 对象数组 | 段落对象列表。 |
keywords | 非必须 | String 数组 | 关键词列表。 |
audio_detect | 必须 | Number | 声纹识别状态: 0:未完成 1:已完成 说明:声纹识别是针对 Rooms 等设备出现一台设备多人讲话场景时,自动区分为多个发言人的能力。声纹识别与纪要生成的过程独立。无需声纹识别或声纹识别已完成时,该值为1。 |
Paragraph 对象
参数名称 | 是否必须 | 参数类型 | 参数描述 |
pid | 必须 | String | 段落 ID。 |
start_time | 必须 | Number | 录制文件中的段落开始时间(毫秒)。 |
end_time | 必须 | Number | 录制文件中的段落结束时间(毫秒)。 |
speaker_info | 必须 | SpeakerInfo 对象 | 发言人信息对象。 |
sentences | 必须 | Sentence 对象数组 | 句子对象列表。 |
SpeakerInfo 对象
参数名称 | 是否必须 | 参数类型 | 参数描述 |
userid | 非必须 | String | 同企业返回企业用户 userid。 |
username | 非必须 | String | 昵称。 |
Sentence 对象
参数名称 | 是否必须 | 参数类型 | 参数描述 |
sid | 必须 | String | 句子 ID。 |
start_time | 必须 | Number | 录制文件中的句子开始时间(毫秒)。 |
end_time | 必须 | Number | 录制文件中的句子结束时间(毫秒)。 |
words | 必须 | Word 对象数组 | 词对象列表。 |
Word 对象
参数名称 | 是否必须 | 参数类型 | 参数描述 |
wid | 必须 | String | 词 ID。 |
start_time | 必须 | Number | 录制文件中的词开始时间(毫秒)。 |
end_time | 必须 | Number | 录制文件中的词结束时间(毫秒)。 |
text | 必须 | String | 文本内容。 |
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
500 | 4049 | 查询单条记录失败,不存在的记录。 |
500 | 70001 | 获取转写详情失败。 |
500 | 30002 | 转写无内容。 |
500 | 403 | 没有资源操作权限。 |
500 | 960000 | 网络错误,请稍后重试。 |
500 | 30003 | 内容生成中,请稍后重试。 |
500 | 90001 | 搜索转写信息失败。 |
500 | 190001 | 存在未注册的用户。 |
500 | 41 | 网络超时。 |
500 | 30001 | 转写不存在。 |
示例
输入示例
GET https://api.meeting.qq.com/v1/records/transcripts/details?record_file_id=1465500000000069281&meeting_id=1647607000000001721&operator_id_type=1&operator_id=meeting1122233
输出示例
{"more":false,"minutes":{"paragraphs":[{"pid":"0","start_time":4400,"end_time":42950,"sentences":[{"sid":"0","start_time":4400,"end_time":9500,"words":[{"wid":"0","start_time":4400,"end_time":4640,"text":"看"},{"wid":"1","start_time":4640,"end_time":5000,"text":"一下"},{"wid":"2","start_time":5000,"end_time":5360,"text":"那个"},{"wid":"3","start_time":8780,"end_time":9260,"text":"哪能"},{"wid":"4","start_time":9260,"end_time":9500,"text":"看。"}]},{"sid":"1","start_time":12140,"end_time":12560,"words":[{"wid":"5","start_time":12140,"end_time":12560,"text":"可以。"}]},{"sid":"2","start_time":14690,"end_time":15680,"words":[{"wid":"6","start_time":14690,"end_time":14930,"text":"好,"},{"wid":"7","start_time":14930,"end_time":15680,"text":"Hao。"}]},{"sid":"3","start_time":26080,"end_time":42950,"words":[{"wid":"8","start_time":26080,"end_time":26500,"text":"这边"},{"wid":"9","start_time":26740,"end_time":26950,"text":"不过"},{"wid":"10","start_time":26950,"end_time":27400,"text":"这边"},{"wid":"11","start_time":31990,"end_time":32290,"text":"哈"},{"wid":"12","start_time":32290,"end_time":32740,"text":"哈"},{"wid":"13","start_time":32770,"end_time":33130,"text":"哈,"},{"wid":"14","start_time":34950,"end_time":35280,"text":"就是"},{"wid":"15","start_time":35280,"end_time":35490,"text":"这里"},{"wid":"16","start_time":35490,"end_time":35790,"text":"面的,"},{"wid":"17","start_time":36990,"end_time":37230,"text":"就是"},{"wid":"18","start_time":37230,"end_time":37380,"text":"这里"},{"wid":"19","start_time":37380,"end_time":37650,"text":"面的"},{"wid":"20","start_time":41600,"end_time":41720,"text":"我"},{"wid":"21","start_time":41720,"end_time":41960,"text":"这"},{"wid":"22","start_time":42350,"end_time":42680,"text":"个人"},{"wid":"23","start_time":42680,"end_time":42950,"text":"用。"}]}],"speaker_info":{"userid":"","username":"测试"}},{"pid":"1","start_time":43920,"end_time":56900,"sentences":[{"sid":"4","start_time":43920,"end_time":45300,"words":[{"wid":"24","start_time":43920,"end_time":44190,"text":"没有"},{"wid":"25","start_time":44190,"end_time":44550,"text":"类型"},{"wid":"26","start_time":44550,"end_time":45030,"text":"还有"},{"wid":"27","start_time":45030,"end_time":45300,"text":"没有。"}]},{"sid":"5","start_time":49800,"end_time":50940,"words":[{"wid":"28","start_time":49800,"end_time":50250,"text":"还有"},{"wid":"29","start_time":50250,"end_time":50460,"text":"就是"},{"wid":"30","start_time":50460,"end_time":50940,"text":"这个。"}]},{"sid":"6","start_time":53190,"end_time":53580,"words":[{"wid":"31","start_time":53190,"end_time":53400,"text":"S"},{"wid":"32","start_time":53400,"end_time":53580,"text":"2。"}]},{"sid":"7","start_time":55190,"end_time":56900,"words":[{"wid":"33","start_time":55190,"end_time":55370,"text":"这"},{"wid":"34","start_time":55370,"end_time":55610,"text":"这"},{"wid":"35","start_time":55610,"end_time":55730,"text":"这"},{"wid":"36","start_time":55730,"end_time":55940,"text":"就是"},{"wid":"37","start_time":55940,"end_time":56210,"text":"他们"},{"wid":"38","start_time":56210,"end_time":56630,"text":"自己"},{"wid":"39","start_time":56630,"end_time":56900,"text":"的。"}]}],"speaker_info":{"userid":"","username":"测试"}},{"pid":"2","start_time":88225,"end_time":93325,"sentences":[{"sid":"8","start_time":88225,"end_time":90985,"words":[{"wid":"40","start_time":88225,"end_time":88735,"text":"哈"},{"wid":"41","start_time":88735,"end_time":89095,"text":"哈"},{"wid":"42","start_time":89095,"end_time":89455,"text":"哈,"},{"wid":"43","start_time":89455,"end_time":89935,"text":"录制"},{"wid":"44","start_time":89935,"end_time":90535,"text":"主持人"},{"wid":"45","start_time":90535,"end_time":90985,"text":"说话。"}]},{"sid":"9","start_time":92005,"end_time":93325,"words":[{"wid":"46","start_time":92005,"end_time":92305,"text":"然后"},{"wid":"47","start_time":92305,"end_time":92485,"text":"再"},{"wid":"48","start_time":92485,"end_time":92905,"text":"增加"},{"wid":"49","start_time":92905,"end_time":93325,"text":"三个。"}]}],"speaker_info":{"userid":"meeting112233","username":"test"}},{"pid":"3","start_time":97889,"end_time":103939,"sentences":[{"sid":"10","start_time":97889,"end_time":99749,"words":[{"wid":"50","start_time":97889,"end_time":98489,"text":"录制"},{"wid":"51","start_time":98489,"end_time":98969,"text":"个人"},{"wid":"52","start_time":98969,"end_time":99749,"text":"用户。"}]},{"sid":"11","start_time":101089,"end_time":103939,"words":[{"wid":"53","start_time":101089,"end_time":101569,"text":"测试"},{"wid":"54","start_time":101569,"end_time":101959,"text":"个人"},{"wid":"55","start_time":101959,"end_time":102619,"text":"用户"},{"wid":"56","start_time":102919,"end_time":103189,"text":"云"},{"wid":"57","start_time":103189,"end_time":103609,"text":"录制"},{"wid":"58","start_time":103609,"end_time":103939,"text":"机。"}]}],"speaker_info":{"userid":"","username":"mints"}}],"keywords":["用户","主持人","类型"],"audio_detect":1}}