设置语音识别热词

最近更新时间:2025-03-05 18:02:23

我的收藏

接口描述

描述
通过接口自定义设置字幕、转写、智能录制等功能的热词。
支持按照会议维度和创建者维度进行设置,会议维度最多支持设置500个,创建者维度最多支持设置100个。
说明:
本接口为覆盖式设置,后调用设置的参数会覆盖之前的设置的参数。
meeting_id 和 record_file_id 的组合关系:
若同时传入 meeting_id 和 record_file_id,则热词仅对该录制文件生效。
若 meeting_id 和 record_file_id 均未传入,则热词对操作者创建的所有会议、所有会议录制文件、所有上传的文件均生效。
请求方式:PUT
鉴权方式:AK/SK 鉴权、OAuth2.0鉴权
接口请求域名
https://api.meeting.qq.com/v1/asr/config


输入参数

参数名称
必选
参数类型
参数描述
operator_id_type
Integer
操作者 ID 类型: 1:userid 2:openid
operator_id
String
操作者ID。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。
tag
String
自定义热词标签,便于热词分类,最多支持输入32个字符(中英文)
customize_words
String[]
自定义热词,不得包含数字、特殊字符、中文十个字以内,英文20个字母以内。同场会议或同一个人每次设置会覆盖上次设置内容。会议维度和录制文件维度最多支持设置500个,会议创建者维度最多支持设置100个。
meeting_id
String
会议 ID,若仅传入 meeting_id,未传入record_file_id,则热词仅对该会议生效。
record_file_id
String
录制文件 ID,若仅传入 record_file_id,未传入 meeting_id,则热词仅对该录制文件生效。

输出参数

参数名称
参数类型
参数描述
tag
String
自定义热词标签。
customize_words
String[]
自定义热词设置结果。

错误码列表

状态码
错误码
错误描述
400
190004
参数非法,请对照接口文档检查您的参数。
400
550000
请求超时,请稍后再试。
400
500089
会议不存在, 请核对 meeting_id。
400
500091
无权限进行该操作,建议检查操作者身份或资源归属。
500
500071
无符合的热词或领域模型。
500
500093
会议状态不为待开始/进行中,请检查。
400
190301
请求重放错误,请求头里的 X-TC-Timestamp 和 X-TC-Nonce 每次请求时需重新生成,不能使用和过去五分钟内相同的 timestamp 和 nonce。
400
500167
录制文件不存在,请检查您的 record_file_id。

示例

输入示例

PUT
https://api.meeting.qq.com/v1/asr/config
{
"operator_id": "afagsagwags",
"operator_id_type": 1,
"tag":"xxxxx",
"customize_words":["xxx"]
}

输出示例

{
"tag":"xxxxx",
"customize_words":["xxx"]
}