开始识别

您可以根据业务场景，按需对某些通话或通话的某些业务阶段进行语音识别。

AI 智能流式语音识别可以在 SDK 直接调用。如果需要在服务端调用，请使用该接口。

开通服务

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

• 开通服务：请在 AI 服务的服务购买页面开通此功能。

• 配置回调地址（可选）：如需接收语音识别状态变更通知，可在控制台的 AI 智能流式语音识别配置页面提供回调地址。

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

请求方法

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

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

请求头

请求头	类型	必传	说明
Content-Type	String	是	固定值：application/json
RC-App-Key	String	是	应用密钥
RC-Nonce	String	是	随机字符串
RC-Timestamp	String	是	时间戳
RC-Signature	String	是	签名
Room-Id	String	是	房间 ID

正文参数

无

请求示例

HTTP

POST /v2/rtc/ai/asr/room/start 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

返回结果

参数	类型	必传	说明
code	Number	是	状态码
errorMessage	String	是	接口调用状态说明

返回结果示例

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

HTTP

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

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

错误响应示例

JSON

{
    "code": 42205,
    "errorMessage": "the roomId was 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/start", 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)
}