关闭同声传译

更新时间: 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
此文档是否对你有帮助?
有帮助
去反馈
  • 功能说明
  • 请求信息
  • 调用时机
  • 请求 URL
  • 请求头参数
  • 请求体参数
  • 请求体示例
  • 响应信息
  • 响应参数
  • 响应头参数
  • 响应体示例
  • 状态码
  • TTS 供应商