音频提取 - CreateExtractAudioTask
功能介绍
本接口为异步接口，创建音频提取任务下发成功后会返回asset_id和提取的audio_asset_id，但此时音频提取任务并没有立即完成，可通过消息订阅界面配置的音频提取完成事件来获取音频提取任务完成与否。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
POST /v1.0/{project_id}/asset/extract_audio
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID，获取方法请参考获取项目ID |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
否 |
String |
用户Token，使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
|
Authorization |
否 |
String |
使用AK/SK方式认证时必选，携带的鉴权信息。 |
|
X-Sdk-Date |
否 |
String |
使用AK/SK方式认证时必选，请求的发生时间。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
asset_id |
是 |
String |
VOD分配的媒资ID，仅支持查询，不支持修改。 |
|
parameter |
否 |
Parameter object |
需要提取音频的参数信息。 |
响应参数
状态码：202
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
asset_id |
String |
视频源媒资ID。 |
|
audio_asset_id |
String |
提取的音频媒资ID。 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 |
|
error_msg |
String |
错误描述。 |
请求示例
提取音频
POST https://{endpoint}/v1.0/{project_id}/asset/extract_audio
Content-Type: application/json
{
"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 |
处理失败返回 |
错误码
请参见错误码。
