文档中心

实时音视频

请输入

API 参考

结束 AI 对话 StopVoiceChat

调用本接口，主动停止一个正在运行的智能体任务。

注意

调用 StopVoiceChat 接口仅会使智能体离开房间，真人用户不会离开房间，仍会产生音视频费用。如需完整结束通话，客户端还需调用 RTC SDK 接口 leaveRoom 使真人用户离开房间，并调用 destroyRTCEngine 销毁引擎实例。

使用说明

调用接口

关于调用接口的请求结构、公共参数、签名方法、返回结构，参看如何调用 OpenAPI。

注意事项

请求频率：QPS 不得超过 60。

请求接入地址：固定为 rtc.volcengineapi.com。

请求说明

请求方式：POST

请求地址：https://rtc.volcengineapi.com?Action=StopVoiceChat&Version=2025-06-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

Query

Action String 必选示例值：StopVoiceChat

接口名称。当前 API 的名称为 StopVoiceChat。

Version String 必选示例值：2025-06-01

接口版本。当前 API 的版本为 2025-06-01。

Body

AppId String 必选示例值：69*****c9

应用的唯一标志。

需与调用 StartVoiceChat 启动任务时使用的 AppId 保持一致。可在音视频互动智能体_应用管理获取。

RoomId String 必选示例值：Room1

通话房间 ID。

需与调用 StartVoiceChat 启动任务时使用的 RoomId 保持一致。

TaskId String 必选示例值：task1

目标智能体任务的 ID。

需与调用 StartVoiceChat 启动任务时定义的 TaskId 保持一致。

返回参数

本接口无特有的返回参数。公共返回参数请见返回结构。

其中返回值 Result 仅在请求成功时返回 ok，失败时为空。

错误码

您可访问公共错误码，获取更多错误码信息。

输入示例 1

输入示例

POST https://rtc.volcengineapi.com?Action=StopVoiceChat&Version=2025-06-01

{
    "AppId": "661e7ae5543cf",
    "RoomId": "Room1",
    "TaskId": "task1"
}

输出示例

{
    "ResponseMetadata": {
        "RequestId": "20251217110420****100232280022D31",
        "Action": "StopVoiceChat",
        "Version": "2025-06-01",
        "Service": "rtc",
        "Region": "cn-north-1"
    }
}

最近更新时间：2026.08.05 12:15:14

这个页面对您有帮助吗？

有用

无用