关闭同声传译

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

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

功能说明

同声传译(Simultaneous Interpretation,简称 SI)服务,又称 AI 翻译官,允许将一种语言的语音实时翻译成另一种语言,并通过文字转语音(TTS)技术将翻译结果以语音方式播放给目标用户。

  • 停止传译时,如果 srcUid 为空,或者 simulInterps 数组为空,表示关闭房间内的所有传译任务。
  • 停止传译时,dstLans 内填写需要停止的对应语言的同声传译;若 dstLans 为空,表示停止该用户的所有同声传译。

请求信息

调用时机

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

请求 URL

服务端 API 调用
  • 请求方法:POST
  • URL:https://rtc-agent.yunxinapi.com/v1/api/ai/si/stop
客户端 API 调用
  • 请求方法:POST
  • URL:https://rtc-agent.yunxinapi.com/v1/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
此文档是否对你有帮助?
有帮助
去反馈
  • 功能说明
  • 请求信息
  • 调用时机
  • 请求 URL
  • 请求头参数
  • 请求体参数
  • 请求体示例
  • 响应信息
  • 响应参数
  • 响应头参数
  • 响应体示例
  • 状态码
  • TTS 供应商