跳到主要内容

获取画布会议录制音频文件

更新时间 2025/02/22 07:19:43

在您触发了会议录制视频的处理任务后, 您可以通过我们提供的 REST API 查询生成的音频文件及转写结果。

前提条件​

请求路径​

https://developer.infi.cn/infi/api/v1/boards/meetings/getAudio

请求参数​

字段
类型
描述
必填
id
string
理录制音频任务 taskId
是

请求参数示例​

{
  "id": "SAMPLE_TASK_ID"
}

请求 curl 示例​

curl --location --request POST \
     --header 'token: YOUR_ACCESS_TOKEN' \
     --header 'Content-Type: application/json' \
     --data '{ PAYLOADS_HERE }' \
     https://developer.infi.cn/infi/api/v1/boards/meetings/getAudio

注意：请确保将 PAYLOADS_HERE 替换为请求参数中列举的数据。

请求成功情况​

响应的 Http 状态码为 200 时表示请求成功。因生成音频文件及处理文字转写通常需要较长的时间，在接口返回内， 我们会通过一个 status 状态位标识生成音频文件任务，及生成文字转写任务的进行状态，该字段值代表的含义如下：

  • 0：任务尚未启动
  • 1：任务进行中
  • 2：任务已完成
  • 3：任务已失败

若任务状态 status 值为 2 ，我们将在接口内提供音频文件公开地址，及文字转写任务状态及内容，返回数据示例如下:

{
  "status": 2,
  "result": {
    "audioUrl": "SAMPLE_PUBLIC_URL",
    "textContent": {
      "data": [],
      "id": "SAMPLE_TRANSCRIPTION_ID",
      "status": 3,
      "textTotalCount": 0
    }
  }
}

字段解释如下：

  • status: 生成音频文件任务进行状态。
  • result: 仅在 status 字段值为 2 时会有值。
  • audioUrl：生成录制音频文件的公开链接。
  • textContent: 文字转写数据。注：需要在发起音频处理任务时，将 needText 参数设置为 true 才会产生此字段。
  • status: 文字转写任务状态。因会晚于音频文件的生成，所以会存在 result.audioUrl 已经就位，但文字转写尚未完成的情况。
  • data: 文字转写数据。
  • textTotalCount: 文字转写计数总数。
  • id：文字转写任务 ID。

若任务状态 status 值为 3 ，我们将在接口内反馈错误原因，返回数据示例如下:

{
  "status": 3,
  "failReason": "SAMPLE_REASON"
}

请求失败情况​

响应的 Http 状态码不为 200 时表示请求失败，如需更多信息请参考请求错误说明文档。