开启同声传译

更新时间: 2025/09/17 09:14:53

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

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

功能说明

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

以旅游场景为例:

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

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

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

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

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

    image.png

请求信息

调用时机

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

请求 URL

服务端 API 调用
  • 请求方法:POST
  • URL:https://rtc-ai.yunxinapi.com/v1/api/si/start
客户端 API 调用
  • 请求方法:POST
  • URL:https://rtc-ai.yunxinapi.com/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 6 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": 6
                            }
                        ],
                        "srcLans": ["zh"],
                        "srcUid": 111
                    }
                ]
            }
        },
        "taskId": "396ca6d5-0288-4e37-9268-be3aae647581"
    }
}

状态码

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

TTS 供应商

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