关闭同声传译
更新时间: 2025/10/27 16:05:41
调用该接口停止同声传译。该任务支持将用户语音实时翻译成指定语言并播放。
功能说明
同声传译(Simultaneous Interpretation,简称 SI)服务,又称 AI 翻译官,允许将一种语言的语音实时翻译成另一种语言,并通过文字转语音(TTS)技术将翻译结果以语音方式播放给目标用户。
- 停止传译时,如果
srcUid为空,或者simulInterps数组为空,表示关闭房间内的所有传译任务。 - 停止传译时,
dstLans内填写需要停止的对应语言的同声传译;若dstLans为空,表示停止该用户的所有同声传译。
请求信息
调用时机
建议在需要跨语言实时交流的场景下使用,如国际会议、多语言在线会议等。
请求 URL
服务端 API 调用
- 请求方法:POST
- URL:
https://rtc-ai.yunxinapi.com/v1/api/si/stop
客户端 API 调用
- 请求方法:POST
- URL:
https://rtc-ai.yunxinapi.com/ai/si/stop
请求头参数
服务端 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 | 是 | - | 停止同声传译任务具体信息。 |
-
meeting |
Object | 是 | - | 同声传译的配置参数。 |
-
simulInterps |
Array | 是 | - | 同声传译的配置参数数组,为空表示停止房间内所有传译任务。 |
srcUid |
Number | 否 | 111 | 源用户ID,为空表示停止房间内所有传译任务。 |
dstLans |
Array | 是 | ["en"] | 目标语言列表,为空表示停止该用户的所有同声传译。dstLans 内填写需要停止的对应语言的同声传译;若 dstLans 为空,表示停止该用户的所有同声传译。 |
请求体示例
JSON{
"cname": "meeting_room123",
"requestId": "396ca6d5-0288-4e37-9268-be3aae647581",
"data": {
"meeting": {
"simulInterps": [
{
"srcUid": 111,
"dstLans": ["en"]
}
]
}
}
}
响应信息
响应参数
| 参数名称 | 类型 | 示例 | 说明 |
|---|---|---|---|
code |
Number | 200 | 状态码,200 表示成功,具体请参考下文状态码。 |
errmsg |
String | "" | 错误信息,成功时为空。 |
响应头参数
响应头部的参数说明请参考 响应概述。
响应体示例
JSON{
"code": 200,
"errmsg": ""
}
状态码
| code | 说明 |
|---|---|
| 200 | 请求成功。 |
| 400 | 参数错误。 |
| 401 | 认证失败。 |
| 429 | 请求频率超出限制,默认上限为 50 次/秒,若您需要上调上限,请参考 如何处理调用服务端 RESTful API 超出频率限制。 |
| 500 | 其他错误。 |
TTS 供应商
| 语种 | 供应商 | ttsVendor |
|---|---|---|
| zh | 豆包 | 6 |
| en | 豆包 | 6 |
| ja | 豆包 | 6 |
| 其他 | minimax | 8 |
此文档是否对你有帮助?





