更新时间:2024-03-20 GMT+08:00
分享

音频提取

功能介绍

本接口为异步接口,创建音频提取任务下发成功后会返回asset_id和提取的audio_asset_id,但此时音频提取任务并没有立即完成,可通过消息订阅界面配置的音频提取完成事件来获取音频提取任务完成与否。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v1.0/{project_id}/asset/extract_audio

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方法请参考获取项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token,使用Token鉴权方式时必选。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

Authorization

String

使用AK/SK方式认证时必选,携带的鉴权信息。

X-Sdk-Date

String

使用AK/SK方式认证时必选,请求的发生时间。

表3 请求Body参数

参数

是否必选

参数类型

描述

asset_id

String

VOD分配的媒资ID,仅支持查询,不支持修改。

parameter

Parameter object

需要提取音频的参数信息。

表4 Parameter

参数

是否必选

参数类型

描述

format

String

封装格式。

取值如下:

  • MP3

  • AAC

响应参数

状态码: 202

表5 响应Body参数

参数

参数类型

描述

asset_id

String

视频源媒资ID。

audio_asset_id

String

提取的音频媒资ID。

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

提取音频

POST https://{endpoint}/v1.0/{project_id}/asset/extract_audio

{
  "asset_id" : "3e1cd21131a94525be55acf65888bf46",
  "parameter" : {
    "format" : "MP3"
  }
}

响应示例

状态码: 202

处理成功返回

{
  "asset_id" : "f488337c31c8e4622f1590735b134c65",
  "audio_asset_id" : "5412"
}

状态码: 400

处理失败返回

{
  "error_code" : "VOD.10062",
  "error_msg" : "Media asset or resource does not exist, please check."
}

状态码

状态码

描述

202

处理成功返回

400

处理失败返回

错误码

请参见错误码

分享:

    相关文档

    相关产品