创建实时会议纪要任务。
前提条件
已开通服务并获取API Key,请配置API Key到环境变量,而非硬编码在代码中,防范因代码泄露导致的安全风险。
当您需要为第三方应用或用户提供临时访问权限,或者希望严格控制敏感数据访问、删除等高风险操作时,建议使用临时鉴权Token。
与长期有效的 API Key 相比,临时鉴权 Token 具备时效性短(60秒)、安全性高的特点,适用于临时调用场景,能有效降低API Key泄露的风险。
使用方式:在代码中,将原本用于鉴权的 API Key 替换为获取到的临时鉴权 Token 即可。
整体调用流程
请参考实时会议。
接入地址
https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
请求方式
POST方法
请求头
Authorization: Bearer sk-xxxxxxxxxxxxxx
Content-Type: application/json
Authorization需替换为实际的API Key
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
model | string | 是 | 定义业务类型,固定为 | tingwu-meeting |
input | object | 是 | 传入相关业务参数 | |
input.type | string | 是 | 表示创建任务类型,创建实时会议任务固定为realtime | realtime |
input.appId | string | 是 | 应用id,可在控制台的应用配置页面获取 | |
input.task | string | 是 | 定义任务类型,固定为 | createTask |
input.format | string | 是 | 表示会议音频的编码格式,目前支持格式:pcm、opus、aac、speex、mp3 创建会议时必填,结束会议并生成纪要时非必填 | pcm |
input.sampleRate | int | 是 | 表示会议音频的采样率,目前支持8000、16000 创建会议时必填,结束会议并生成纪要时非必填 | 16000 |
input.phraseId | string | 否 | 热词表id,可在控制台热词库页面中获取 创建会议时必填,结束会议并生成纪要时非必填 | |
input.dataId | string | 是 | 创建会议时获取的dataId 结束会议并生成纪要时必填,创建会议时非必填 | |
parameters | object | 否 | 实时会议纪要生成控制参数,若传入空对象则复用已发布上线的配置项 | |
parameters.transcription | object | 否 | 转写相关控制参数 | |
parameters.transcription.model | string | 否 | 转写模型,可选值:
| multilingual |
parameters.transcription.languageHints | array | 否 | 当且仅当 | ["cn", "en"] |
parameters.transcription.diarizationEnabled | bool | 否 | 表示是否开启发言人分离 | true |
parameters.transcription.diarizationSpeakerCount | int | 否 | 表示发言人分离的目标个数,可选值:
默认值为0 | 0 |
parameters.transcription.translationEnabled | bool | 否 | 是否开启翻译 | true |
parameters.transcription.translationTargetLang | array | 否 | 如果开启翻译,需要设置目标翻译语言,目前支持的目标语种有:
目前仅支持单选 | ["en"] |
parameters.audio | object | 否 | 音频相关参数 | |
parameters.audio.audioChannelMode | string | 否 | 多音轨配置项,可选值:
若传空字符串不传该参数,则会根据音频采样率进行不同操作:
| mix |
parameters.analysis | object | 否 | 大模型分析参数 | |
parameters.analysis.model | string | 否 | 全局分析模型,可选值:
| tingwu-plus |
parameters.analysis.keyInformationEnabled | bool | 否 | 是否提取关键词 | true |
parameters.analysis.actionsEnabled | bool | 否 | 是否提取待办 | true |
parameters.analysis.fullSummaryEnabled | bool | 否 | 是否提取全文摘要 | true |
parameters.analysis.fullSummaryFormat | string | 否 | 提取全文摘要的形式,可选值:
仅当 | default |
parameters.analysis.conversationalEnabled | bool | 否 | 是否提取发言人总结 | true |
parameters.analysis.questionsAnsweringEnabled | bool | 否 | 是否提取问答回顾(或要点回顾) | true |
parameters.analysis.mindMapEnabled | bool | 否 | 是否提取思维导图 | true |
parameters.analysis.mindMapFormat | string | 否 | 提取的思维导图格式,可选值:
仅当 | timestamp |
parameters.analysis.pptExtractionEnabled | bool | 否 | 是否提取视频中PPT及PPT摘要 | true |
parameters.analysis.autoChaptersEnabled | bool | 否 | 是否开启章节速览 | true |
parameters.analysis.autoChapterGranularity | string | 否 | 章节速览提取粒度,可选值:
仅当 | Coarse |
parameters.analysis.autoChapterTitleLengthLevel | string | 否 | 章节标题长度级别,可选值:
仅当 | Normal |
parameters.analysis.textPolishEnabled | bool | 否 | 是否将口语书面化 | true |
parameters.analysis.customPromptEnabled | bool | 否 | 是否开启自定义Prompt | true |
parameters.analysis.customPromptModel | string | 否 | 自定义Prompt的分析模型,可选值:
仅当 | tingwu-plus |
parameters.analysis.customPromptTransType | string | 否 | 控制在Prompt中,
仅当 | chat |
parameters.analysis.customPromptContent | string | 否 | 自定义Prompt 仅当 注意您必须在此项中加入 若未设置 | 请帮我提取原文中每个发言人Id对应的角色,可能存在的角色有销售人员和试驾客户。原文结果如下:{Transcription} |
返回参数
名称 | 类型 | 描述 | 示例值 |
output | object | ||
output.dataId | string | 任务id | |
output.status | int |
| 3 |
usage | object | 用量,目前为空object | {} |
code | string | 错误码 | InvalidParameter |
message | string | 错误信息 | Agent Input text format error. |
request_id | string | 请求id | f97ee37d-0f9c-9b93-b6bf-bd263a232bf9 |
请求示例
请求头Authorization中的"sk-***"需要替换为真实的阿里云百炼API Key。
创建实时会议
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
--header 'Authorization: Bearer sk-******e181c' \
--header 'Content-Type: application/json' \
--data '{
"model": "tingwu-meeting",
"input": {
"task": "createTask",
"appId": "tw_***",
"type": "realtime",
"format": "pcm",
"sampleRate": 16000,
"phraseId": "DEA******Isv"
},
"parameters": {
"transcription": {
"model": "multilingual",
"languageHints": ["cn", "en"],
"diarizationEnabled": true,
"diarizationSpeakerCount": 0,
"translationEnabled": true,
"translationTargetLang": ["ja"]
},
"audio": {
"audioChannelMode": ""
},
"analysis": {
"model": "default",
"keyInformationEnabled": true,
"actionsEnabled": false,
"fullSummaryEnabled": true,
"fullSummaryFormat": "default",
"conversationalEnabled": false,
"questionsAnsweringEnabled": false,
"mindMapEnabled": true,
"mindMapFormat": "plain",
"pptExtractionEnabled": false,
"autoChaptersEnabled": true,
"autoChapterGranularity": "Coarse",
"autoChapterTitleLengthLevel": "Short",
"textPolishEnabled": false,
"customPromptEnabled": true,
"customPromptModel": "tingwu-turbo",
"customPromptTransType": "chat",
"customPromptContent": "请帮我提取原文中每个发言人Id对应的角色,可能存在的角色有销售人员和试驾客户。原文结果如下:{Transcription}"
}
}
}'
结束实时会议并创建会议纪要
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
--header 'Authorization: Bearer sk-******e181c' \
--header 'Content-Type: application/json' \
--data '{
"model": "tingwu-meeting",
"input": {
"task": "createTask",
"appId": "tw_***",
"type": "realtime",
"dataId": "BEc******syu"
}
}'