查询单个录制详情(文件、转写、纪要)

最近更新时间:2025-10-11 10:35:42

我的收藏

接口描述

描述:查询单个云录制的详情信息,包括录制文件和录制转写,并可获取播放地址和下载地址。
注意:
企业 secret 鉴权用户可获取该用户所属企业下的单个录制列表。
OAuth 2.0鉴权用户只能获取该企业下 OAuth 2.0应用的单个录制列表。
请求方法:GET
鉴权方式:支持 AK/SK 和 OAuth 2.0鉴权。
依赖权限点
自建应用:具备管理企业录制查看企业录制权限。
三方应用:具备查看您的录制查看和管理您的录制权限。
Operator 用户角色:勾选账户管理 > 录制管理 > 查看权限。可前往用户管理 > 角色管理页面设置。
接口请求域名
https://api.meeting.qq.com/v1/addresses/{record_file_id}?operator_id={operator_id}&operator_id_type={operator_id_type}


输入参数

以下请求参数列表仅列出了接口请求参数,HTTP 请求头公共参数请参见签名验证章节的 公共参数说明

路径参数

参数名称
必选
参数类型
参数描述
record_file_id
String
录制文件 ID,列表接口返回的 record_file_id。

查询参数

参数名称
必选
参数类型
参数描述
operator_id
String
操作者 ID。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。
说明:仅会议创建者、企业超级管理员或有企业录制管理权限的用户可调用(企业内部请使用企业唯一用户标识;OAuth 2.0鉴权用户请使用 openid)。
企业唯一用户标识说明
1:企业对接 SSO 时使用的员工唯一标识 ID。
2:企业调用创建用户接口时传递的 userid 参数
operator_id_type
Integer
操作者 ID 的类型:
1:userid
2:openid
3:rooms_id

输出参数

参数名称
参数类型
参数描述
record_file_id
String
录制文件 ID。
meeting_id
String
会议 ID。
meeting_code
String
会议 code。
view_address
String
播放地址。
download_address
String
录制文件下载地址,链接有效期为5分钟。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
download_address_file_type
String
下载视频文件格式,例如:mp4。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
audio_address
String
音频下载地址,链接有效期为5分钟。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
audio_address_file_type
String
下载音频文件格式,例如:m4a。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
meeting_summary
录制转写文件列表。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
ai_meeting_transcripts
录制转写文件(智能优化版)列表。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
ai_minutes
混元-章节纪要列表。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
如果该录制文件未打开“允许下载”,则该值返回为空。
ai_topic_minutes
混元-主题纪要列表。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
如果该录制文件未打开“允许下载”,则该值返回为空。
ai_speaker_minutes
混元-发言人纪要列表。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
如果该录制文件未打开“允许下载”,则该值返回为空。
ai_ds_minutes
DeepSeek-纪要列表。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
如果该录制文件未打开“允许下载”,则该值返回为空。

MeetingSummary 对象

参数名称
参数类型
参数描述
download_address
String
录制转写文件下载文件地址,链接有效期为5分钟。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
file_type
String
下载文件类型,例如:txt、pdf、docx。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。

MeetingTranscripts 对象

参数名称
参数类型
参数描述
download_address
String
录制转写文件下载文件地址,链接有效期为5分钟。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
file_type
String
下载文件类型,例如:txt、pdf、docx。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。

Minutes 对象

参数名称
参数类型
参数描述
download_address
String
智能纪要文件下载文件地址,链接有效期为5分钟。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
file_type
String
下载文件类型,例如:txt、pdf、docx。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。

错误码列表

状态码
错误码
错误描述
400
190004
参数非法,请对照接口文档检查您的参数。
400
9042
权限受限或鉴权失败。
400
500014
账号无权限。
500
190001
存在未注册的用户。
500
960000
网络错误,请稍后重试。
500
190310
每分钟总接口调用次数超过限制。
500
4051
录制文件已经被删除。
500
4049
查询单条记录失败,不存在的记录。
500
41
网络超时。
500
403
没有资源操作权限。

示例

输入示例

GET https://api.meeting.qq.com/v1/addresses/1318080811111111111?operator_id=KM4Ss4Th09ogUw1JiK&operator_id_type=1


输出示例

{
"meeting_id":"1318080811111111111",
"meeting_code":"423411111",
"record_file_id":"1318080811111111111",
"view_address":"https://yunluzhi-brucetest...",
"download_address":"https://yunluzhi-brucetest...",
"download_address_file_type":"mp4",
"audio_address":"https://yunluzhi-brucetest...",
"audio_address_file_type":"m4a",
"meeting_summary":[
{
"download_address":"https://yunluzhi-brucetest...",
"file_type":"txt"
}
],
"ai_meeting_transcripts":[
{
"download_address":"https://yunluzhi-brucetest...",
"file_type":"txt"
}
],
"ai_minutes":[
{
"download_address":"https://yunluzhi-brucetest...",
"file_type":"txt"
}
],
"ai_topic_minutes":[
{
"download_address":"https://yunluzhi-brucetest...",
"file_type":"htm"
}
],
"ai_speaker_minutes":[
{
"download_address":"https://yunluzhi-brucetest...",
"file_type":"htm"
}
],
"ai_ds_minutes":[
{
"download_address":"https://yunluzhi-brucetest...",
"file_type":"htm"
}
]
}