转录结果查询接口

更新时间:

通过 taskId 查询长音频转录结果。

POSThttps://asr.ilivedata.com/api/v1/speech/recognize/result

请求参数

请求头

以下请求头均为必需。

Header 值 说明
Content-Type application/json; charset=UTF-8 请求体格式
Accept application/json; charset=UTF-8 响应格式
X-AppId — 控制台「服务配置」中的项目编号
X-TimeStamp — 请求发起时的 UTC 时间，采用 W3C 格式。
格式示例：2026-09-30T02:30:00Z，实际请求需使用当前时间。
Authorization — 签名值，计算方式见下文「请求签名」

请求体

参数 类型 必需 说明
taskId String 必需 任务ID

请求示例

{
  "taskId": "us_a0cf4d0c-4804-484d-96e1-9ebf1e42d37d_1614329510676"
}

请求签名

按照帮助中心的请求签名计算 Authorization，使用以下接口参数。

签名参数 值
HTTPMethod POST
HostHeaderInLowercase asr.ilivedata.com
HTTPRequestURI /api/v1/speech/recognize/result

HTTP 响应

Content-Type: application/json;charset=UTF-8

响应字段

字段 类型 说明
errorCode Number 错误代码
errorMessage String 错误消息
taskId String 任务ID
status Number 任务状态
transcripts Array 转录文本数组

transcripts[]

字段 类型 说明
startTime Number 起始时间偏移
endTime Number 结束时间偏移
text String 从音频中识别出的文本
speaker Number 在开启区分讲话人选项时，返回讲话人序号

响应示例

{
  "errorCode": 0,
  "taskId": "us_a0cf4d0c-4804-484d-96e1-9ebf1e42d37d_1614329510676",
  "status": 0,
  "transcripts": [
    {
      "startTime": 0.0,
      "endTime": 4.97,
      "text": "杭州822路公交车经过站点。",
      "speaker": 1
    }
  ]
}

错误码

HTTP 状态码 错误码 错误消息
200 0 此字段省略
429 1104 Out of Rate Limit
429 1105 Out of Quotas
405 1004 Method Not Allowed
411 1007 Not Content Length
400 1002 API Not Found
400 1003 Bad Request
400 2000 Missing Parameter
400 2001 Invalid Parameter
400 2002 Invalid Request
400 2102 Input Too Long
400 2109 Speech Recognition Failed
400 2110 File is invalid
400 2111 Failed to download file
400 2112 TaskId is invalid
401 1102 Unauthorized Client
401 1106 Missing Access Token
401 1107 Invalid Token
401 1108 Expired Token
401 1110 Invalid Client