跳到主要内容

停止识别

会话结束时自动停止识别。如需手动结束识别任务,可调用该接口。

开通服务

在使用 AI 智能流式语音识别任务管理 API 之前,请确认已完成以下步骤:

  • 开通服务:请提交工单开通此功能。

  • 配置回调地址(可选):如需接收语音识别状态变更通知,可在工单中提供回调地址。

    • 回调地址示例:http(s)://your.app.server/any-url-path
    • 配置完成后,您的 App 内所有房间的 AI 智能流式语音识别状态变更,均会通过 HTTP 请求实时回调您的服务器
    • 回调 URL 必须是公网可访问的 URL 地址

请求方法

POST: https://数据中心域名/v2/rtc/ai/asr/room/stop

签名规则:所有请求服务端 API 接口的请求均需要进行规则校验,详见 API 请求签名

请求头

请求头类型必传说明
Content-TypeString固定值:application/json
RC-App-KeyString应用密钥
RC-NonceString随机字符串
RC-TimestampString时间戳
RC-SignatureString签名
Room-IdString房间 ID

正文参数

请求示例

HTTP
POST /v2/rtc/ai/asr/room/stop HTTP/1.1
Host: api.rong-api.com
Content-Type: application/json
RC-App-Key: c9kqb3rdkbb8j
RC-Nonce: 1027489915
RC-Timestamp: 1609754958
RC-Signature: 357cef9b529edd1ed4f34bd8df52de00a909914b
Room-Id: room_123

返回结果示例

返回结果包含具有以下结构的 JSON 对象:

HTTP
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
"code": 10000,
"errorMessage": "success"
}

错误响应示例

JSON
{
"code": 40003,
"errorMessage": "set asr start flag, room not exist"
}

使用示例

Go
package main

import (
"bytes"
"encoding/json"
"fmt"
"net/http"
"time"
)

func main() {
// 创建请求
req, err := http.NewRequest("POST", "https://api.rong-api.com/v2/rtc/ai/asr/room/stop", nil)
if err != nil {
fmt.Printf("Create request error: %v\n", err)
return
}

// 设置请求头
req.Header.Set("Content-Type", "application/json")
req.Header.Set("RC-App-Key", "your_app_key")
req.Header.Set("RC-Nonce", "1027489915")
req.Header.Set("RC-Timestamp", fmt.Sprintf("%d", time.Now().Unix()))
req.Header.Set("RC-Signature", "your_signature")
req.Header.Set("Room-Id", "room_123")

// 发送请求
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
fmt.Printf("Request error: %v\n", err)
return
}
defer resp.Body.Close()

// 处理响应
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Printf("Response: %+v\n", result)
}