AI 转录/翻译 2.0 迁移说明

最近更新时间:2026-04-20 10:56:11

我的收藏
TRTC AI 转录/翻译 2.0 对 1.0 的使用配置和回调方式进行了优化。若需要升级到 2.0 版本,请参见本文对于接入传参的差异说明。

发起任务的差异

通用参数的差异

2.0版本去掉了 SessionId 参数,可以不用传入 SessionId。

转录机器人参数的差异

2.0版本的机器人进房参数更简洁。差异如下:
回调转录翻译结果的方式:2.0 版本通过 SendCustomMode 参数控制回调转录翻译结果的方式,推荐设置 SendCustomMode 为 1 以使用自定义数据的方式回调,自定义数据回调方式相较于 1.0 版本自定义消息方式可靠性更高。
订阅用户的管理方式:1.0版本使用 TranscriptionMode、TargetUserId、TargetUserIdList 这三个参数管理订阅的用户,2.0 版本可以使用 SubscribeList 和 UnSubscribeList 参数通过订阅黑白名单的机制来管理订阅用户。
配置项
旧版本 1.0 RecognizeConfig 参数
新版本 2.0 AsrParam 参数
迁移建议
机器人信息
UserId
UserSig
MaxIdleTime
UserId
UserSig
MaxIdleTime
保持原始参数设置。
回调转录翻译结果
IMAdminUserId
IMAdminUserSig
SendCustomMode
推荐通过设置 SendCustomMode 为1来使用自定义数据方式进行回调。若需要继续使用自定义消息方式回调可设置 SendCustomMode 为 2。
订阅用户的管理
TranscriptionMode
TargetUserId
TargetUserIdList
SubscribeList
UnSubscribeList
推荐通过 SubscribeList 设置要订阅的用户,通过 UnSubscribeList 设置不订阅的用户。
不设置这两个参数时默认订阅所有用户。使用黑白名单时,同一个用户同时在黑白名单时,以黑名单为主。
声纹、断句配置
VoicePrint
TurnDetection
不支持
不设置这两个参数。

语音识别参数的差异

对于语音识别(ASR) 功能,1.0版本使用 RecognizeConfig 参数作为语音识别的配置参数,2.0版本使用 AsrParam 参数作为语音识别的配置参数,具体的配置子项参数名完全一致。
注意:2.0版本模糊识别支持的语言仅支持高级版 ASR 语种,详情参见 高级版语种列表

翻译参数的差异

配置项
旧版本 1.0 TranslationConfig 参数
新版本 2.0 TranslationParam 参数
迁移建议
翻译目标语言
TargetLanguages

TargetLang

使用 TargetLang 配置项替代 TargetLanguages 配置项。
TTS 配置
TTSConfig
不支持
如果需要使用 TTS 实现翻译同声传译的请继续使用 1.0 版本接口。
翻译术语表
Terminology
Terminology
-

查询任务的差异

2.0版本查询转录任务时只用填写 SdkAppId 和 TaskId,返回结果是任务的开始时间和状态。
参数
旧版本 1.0 DescribeAITranscription
新版本 2.0 DescribeCloudTranscription
迁移建议
输入参数
TaskId
SdkAppId
SessionId
TaskId
SdkAppId
只用填写 TaskId 和
SdkAppId 参数
返回参数
StartTime
Status
TaskId
SessionId
StartTime
Status
TaskId
-

停止任务的差异

相较于 1.0 版本,2.0版本停止任务需要填写 SdkAppId 参数,其余用法保持一致。