实时翻译

除了将频道中主播的音频实时转写为文本，声网还支持在转写时进行翻译。例如，在国际会议等场景下，你可以将频道中主播的发言转写为文本，然后对转写后的内容进行翻译，最后将原文和译文以字幕的形式推送回频道内。

本文介绍如何调用 Voice AI 的 RESTful API 将转写的内容翻译为指定的语言。

前提条件

开始前，您需要先确认您开通的服务，目前声网有 STT-CN 和 STT-Global 两种服务：

• STT-CN：适合国内用户，服务部署在国内，请先联系声网销售开通 STT-CN 服务，目前 STT-CN 暂不支持自服务开通 
• STT-Global：适合国内出海用户，服务部署在海外，请访问 Agora 官网参考实现语音转文字完成 HTTP 认证、获取资源、开启转写任务

翻译转写内容

在调用 start 开始转写任务时，设置 translateConfig 来对转写的文本内容进行翻译。

请求示例

如下示例展示如何在转写时设置翻译。下面是一个完成的请求示例，包含 URL、header、body。如需在转写任务中同时进行录制、加密，请参考Record captions、Encrypt captions。

Shell

curl --location --request POST 'https://api.sd-rtn.com/cn/v2/projects/{{appId}}/rtsc/speech-to-text/tasks?builderToken={{tokenName}}' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: <http_basic_auth>' \
--data '{
    "languages": [
        "zh-CN"
    ],
    "maxIdleTime": 50,
    "rtcConfig": {
        "channelName": "<YourChannelName>",
        "subBotUid": "<YourSubscribeUid>",
        "pubBotUid": "<YourPublishUid>",
        "subscribeAudioUids": [uint]
    },
    "translateConfig": {
        "languages": [
            {
                "source": "zh-CN",
                "target": [
                    "en-US",
                    "ar-SA",
                    "id-ID",
                    "fr-FR",
                    "ja-JP"
                ]
            }
        ]
    }
}'

以下介绍实时翻译的关键配置。

1. 指定需要转写的主播的 ID 和其所在的频道名。 在 rtcConfig 中通过 subscribeAudioUids 设置需要转写的用户 ID，一个转写任务中最多同时支持转写 5 个用户的音频，通过 channelName 设置频道名。其他参数的配置可参考实现语音转文字。

2. 设置 languages 数组。数组长度最大为 2，即最多支持同时翻译两个不同的源语种。

   参数名	类型	含义
   source	String Array	翻译时的源语种。
   target	array	翻译时的目标语种，最多支持配置 5 个目标语种。支持的语种类别详见语言列表。

注意

• 目前同一转写任务中，最多支持同时翻译 5 个主播的转写内容。
• 翻译时，源语种和目标语种不能设为一致，否则会报错。

响应示例

JSON

{
   "taskId": "String",
   "createTs": number,
   "status": enum(STATUS)
}

参数名	类型	含义
taskId	string	任务 ID。
createTs	number	任务创建的时间戳。
status	enum	任务状态： IDLE：任务未初始化。 PREPARING：任务已收到初始化请求。 PREPARED：任务初始化完成。 STARTING：任务开始启动。 CREATED：部分任务启动完成。 STARTED：所有任务启动完成。 IN_PROGRESS：任务进行中。 STOPPING：任务暂停。 STOPPED：任务终止。 FAILURE_STOP：任务终止失败。

调用 start 开启实时转写任务，且设置翻译配置后，你可以参考实现实现语音转文字进行查询、更新、停止任务等操作。

语言列表

下表展示翻译功能所支持的语种：

语言名称	参数
泰语	th-TH
越南语	vi-VN
土耳其语	tr-TR
俄语	ru-RU
马来语	ms-MY
波斯语（伊朗）	fa-IR
粤语（繁体）	zh-HK
印度尼西亚语	id-ID
阿拉伯语（约旦）	ar-JO
阿拉伯语（埃及）	ar-EG
阿拉伯语（沙特）	ar-SA
阿拉伯语（阿联酋）	ar-AE
中文（简体）	zh-CN
中文（繁体）	zh-TW
英语	en-US
印地语	hi-IN
韩语	ko-KR
日语	ja-JP
德语	de-DE
西班牙语	es-ES
法语	fr-FR
意大利语	it-IT
葡萄牙语	pt-PT