使用CreateMeetingTrans API创建实时会议-工作学习 AI 助手通义听悟-阿里云

创建实时会议。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
tingwu:CreateMeetingTrans		全部资源 ``	无	无

请求语法

PUT /openapi/meeting-trans HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求 body。
AppKey	string	是	管控台创建的项目 AppKey。	JV1sRTisRMi****
MeetingKey	string	否	用户设置的会议标识，在会中查询或会后结束回调时会原样返回。	meeting_123
AudioFormat	string	是	音频编码格式，PCM（无压缩的 PCM 文件或 WAV 文件）或 OPUS（压缩的 OPUS 文件）。	pcm
AudioPackage	string	否	音频打包方式，基于听悟约定的 Protobuf 格式封装多路音频流时设置为 multi。	multi
AudioSampleRate	integer	是	音频采样率，当前支持：16000、8000（仅支持单路中文）。	16000
AudioBitRate	integer	是	会议上传音频采样位数，当前支持：16。	16
AudioLanguage	string	是	音频转写使用的语言模型。 cn：中文。 en：英文。 yue：粤语。 fspk：中英文自由说。	cn
RealtimeResultEnabled	boolean	否	是否开启会中实时结果返回，默认是 true。	true
RealtimeResultLevel	integer	否	开启会中实时结果返回时，设置识别结果返回等级，默认是 1。 0：不返回识别结果。 1：识别出完整句子时返回识别结果。 2：识别出中间结果及完整句子时返回识别结果。	2
RealtimeActiveResultLevel	integer	否	开启会中实时结果返回且音频打包方式为 multi 时，设置发言人识别结果返回等级，默认是 1。 0：不返回识别结果。 1：识别出完整句子时返回识别结果。 2：识别出中间结果及完整句子时返回识别结果。	2
AudioOutputEnabled	boolean	否	是否开启 mp3 格式音频同步转码，默认是 false。	false
AudioOutputOssBucket	string	否	开启音频同步转码时，转码音频写入到的 OSS Bucket，需要与管控台项目配置的 OSS Bucket 一致。	bucket
AudioOutputOssPath	string	否	开启音频同步转码时，转码音频写入到的 OSS 文件路径，需要以"tingwu/"为前缀。	tingwu/dir/filename
MeetingResultEnabled	boolean	否	是否开启会后智能提取，默认是 false。	false
MeetingResultOssBucket	string	否	开启会后智能提取时，提取结果写入到的 OSS Bucket，需要与管控台项目配置的 OSS Bucket 一致。	bucket
MeetingResultOssPath	string	否	开启会后智能提取时，提取结果写入到的 OSS 文件路径，需要以"tingwu/"为前缀。	tingwu/dir/filename
DocResultEnabled	boolean	否	开启会后智能提取时，是否会中识别结果写入，默认是 false。	false
AudioSegmentsEnabled	boolean	否	开启会后智能提取时，是否开启有效音频片断检测结果写入，默认是 false。	false
TranslateResultEnabled	boolean	否	是否开启会中翻译，默认是 false。	false
TranslateLanguages	string	否	翻译目标语言集合，多个语言间用英文逗号","分隔，当前支持 cn、en。	cn,en
TranslateResultLevel	integer	否	单通道识别或多通道 mix 流识别结果翻译等级。0：不返回翻译结果。1：识别出完整句子时返回翻译结果。2：识别出中间结果及完整句子时返回翻译结果。默认是 1。	2
TranslateActiveResultLevel	integer	否	多通道 Active 流识别结果翻译等级。0：不返回翻译结果。 1：识别出完整句子时返回翻译结果。 2：识别出中间结果及完整句子时返回翻译结果。默认是 1。	2
RealtimeResultWordsEnabled	boolean	否	会中识别消息是否包含 words 信息，默认是 true。	true
RealtimeResultMeetingInfoEnabled	boolean	否	会中识别消息结果 header 中是否包含 MeetingKey、MeetingId，默认是 false。	true
Tags	object	否	系统扩展：标签
AsrParams	object	否	ASR 转写的额外参数，如热词 vocabulary_id	{ "vocabulary_id": "e2a9a9be3128417fb4d181ebfbe8****" }
LabParams	object	否	系统扩展：实验转写参数
AbilityParams	object	否	能力扩展

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID，仅用于联调。	35124E1C-AE99-5D6C-A52E-BD689D8D****
Code	string	状态码。	0
Message	string	状态说明。	Success.
Data	object	返回对象。
MeetingId	string	会议 ID。	f7de74778d94422283534102dfc0****
MeetingJoinUrl	string	会议语音推流地址。	wss://tingwu-realtime-cn-beijing.aliyuncs.com/api/ws/v1?mc=****
MeetingKey	string	用户创建会议时设置的会议标识。	meeting_123

示例

正常返回示例

JSON格式

{
  "RequestId": "35124E1C-AE99-5D6C-A52E-BD689D8D****",
  "Code": 0,
  "Message": "Success.",
  "Data": {
    "MeetingId": "f7de74778d94422283534102dfc0****",
    "MeetingJoinUrl": "wss://tingwu-realtime-cn-beijing.aliyuncs.com/api/ws/v1?mc=****",
    "MeetingKey": "meeting_123"
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2023-05-16	API 内部配置变更，不影响调用	查看变更详情