开启同声传译

更新时间: 2026/07/07 15:12:45

调用该接口开启同声传译。该任务支持将用户语音实时翻译成指定语言并播放。

如果您需要使用该接口,请 提交工单 联系网易云信技术支持工程师开通。

功能说明

同声传译(Simultaneous Interpretation,简称 SI)服务,又称 AI 翻译官,允许将一种语言的语音实时翻译成另一种语言,并通过文字转语音(TTS)技术将翻译结果以语音方式播放给目标用户。适用于跨语言导游直播、多语言会议、国际性在线教育、跨语言媒体内容实时转换业务场景。

以旅游场景为例:

  1. 游客端触发翻译任务后,系统自动生成翻译请求,创建目标语言的 AI 翻译官实例。

  2. 导游端将原声音频流实时推送至网易云信 RTC 服务器。

  3. 网易云信 RTC 服务器将导游音频转发至对应的 AI 翻译官服务。

  4. AI 翻译官完成翻译(例如,英语/日语/X 语),并将翻译后的音频流推送回业务服务器。

  5. 游客端根据所选语种,订阅并接收对应翻译官的音频流。

    image.png

请求信息

调用时机

建议在需要跨语言实时交流的场景下使用,如国际会议、多语言在线会议等。

请求 URL

服务端 API 调用
  • 请求方法:POST
  • URL:https://rtc-agent.yunxinapi.com/v1/api/ai/si/start
客户端 API 调用
  • 请求方法:POST
  • URL:https://rtc-agent.yunxinapi.com/v1/ai/si/start

请求头参数

服务端 API 调用

请求头部的参数说明请参考 请求结构。

客户端 API 调用
参数名称 类型 是否必选 说明
AppKey String 是 请登录 网易云信控制台 查看您的应用对应的 AppKey,具体请参考 创建应用并获取 AppKey。
Token String 是 客户端向用户服务器请求并获取的 Token,具体请参考 获取 Token。
Cname String 是 获取 Token 时使用的 channelName,即 RTC 房间名称。
Uid String 是 获取 Token 时使用的 uid,即用户在您应用中的 ID。

请求体参数

参数名称 类型 是否必选 取值示例 说明
cname String 是 "meeting_room123" 房间名称。
requestId String 否 "396ca6d5-0288-4e37-9268-be3aae647581" 任务 ID。您可以设置为随机字符串,用于问题排查。
- data Object 是 - 创建的同声传译任务具体信息。
- tts Object 是 - 文字转语音 TTS AI 任务参数信息。
gender String 否 "Male" TTS 音色性别,默认值为 "Female",可选值:Female、Male。
- meeting Object 是 - 同声传译的配置参数。
- simulInterps Array 是 - 同声传译的配置参数数组。
srcUid Number 是 111 源用户 ID。
srcLans Array 是 ["zh"] 源语言列表,支持的语言参考 语言代码表。
dstLans Array 是 ["en"] 目标语言列表,支持的语言参考 语言代码表。

请求体示例

JSON{
    "cname": "meeting_room123",
    "requestId": "396ca6d5-0288-4e37-9268-be3aae647581",
    "data": {
        "tts": {
            "gender": "Male"
        },
        "meeting": {
            "simulInterps": [
                {
                    "srcUid": 111,
                    "srcLans": ["zh"],
                    "dstLans": ["en"]
                }
            ]
        }
    }
}

响应信息

响应参数

参数名称 类型 示例 说明
code Number 200 状态码,200 表示成功,具体请参考下文状态码。
requestId String "111-222-333" 请求的唯一标识。
cid Number 1649062595110672 房间 ID。
- result Object - 创建任务结果。
- data Object - 任务数据。
- meeting Object - 会议信息。
- simulInterps Array - 同声传译配置数组。
- simulInterp Array - 同声传译详细配置。
dstLan String "en" 目标语言。
simulInterpUid Number 1749559584 AI 翻译官的 ID。
ttsVendor Number 10 TTS 供应商 ID。详细请参考下文 TTS 供应商。
srcLans Array ["zh"] 源语言列表。
srcUid Number 111 源用户 ID。
taskId String "396ca6d5-0288-4e37-9268-be3aae647581" 任务唯一标识符,房间内唯一。

响应头参数

响应头部的参数说明请参考 响应概述。

响应体示例

JSON{
    "code": 200,
    "requestId": "111-222-333",
    "cid": 1649062595110672,
    "result": {
        "data": {
            "meeting": {
                "simulInterps": [
                    {
                        "simulInterp": [
                            {
                                "dstLan": "en",
                                "simulInterpUid": 1749559584,
                                "ttsVendor": 10
                            }
                        ],
                        "srcLans": ["zh"],
                        "srcUid": 111
                    }
                ]
            }
        },
        "taskId": "396ca6d5-0288-4e37-9268-be3aae647581"
    }
}

状态码

code 说明
200 请求成功。
400 参数错误。
401 认证失败。
429 请求频率超出限制,默认上限为 50 次/秒,若您需要上调上限,请参考 如何处理调用服务端 RESTful API 超出频率限制。
500 其他错误。

TTS 供应商

语种 供应商 ttsVendor
zh 豆包 10
en 豆包 10
ja 豆包 10
其他 minimax 8
此文档是否对你有帮助?
有帮助
去反馈
  • 功能说明
  • 请求信息
  • 调用时机
  • 请求 URL
  • 请求头参数
  • 请求体参数
  • 请求体示例
  • 响应信息
  • 响应参数
  • 响应头参数
  • 响应体示例
  • 状态码
  • TTS 供应商