开启同声传译
更新时间: 2025/09/17 09:14:53
调用该接口开启同声传译。该任务支持将用户语音实时翻译成指定语言并播放。
功能说明
同声传译(Simultaneous Interpretation,简称 SI)服务,又称 AI 翻译官,允许将一种语言的语音实时翻译成另一种语言,并通过文字转语音(TTS)技术将翻译结果以语音方式播放给目标用户。适用于跨语言导游直播、多语言会议、国际性在线教育、跨语言媒体内容实时转换业务场景。
以旅游场景为例:
-
游客端触发翻译任务后,系统自动生成翻译请求,创建目标语言的 AI 翻译官实例。
-
导游端将原声音频流实时推送至网易云信 RTC 服务器。
-
网易云信 RTC 服务器将导游音频转发至对应的 AI 翻译官服务。
-
AI 翻译官完成翻译(例如,英语/日语/X 语),并将翻译后的音频流推送回业务服务器。
-
游客端根据所选语种,订阅并接收对应翻译官的音频流。
请求信息
调用时机
建议在需要跨语言实时交流的场景下使用,如国际会议、多语言在线会议等。
请求 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 |
此文档是否对你有帮助?





