6.3 取消媒资转码任务 6.4 音频提取
6.5 取消提取音频任务 6.6 创建审核媒资任务 6.7 设置封面
6.1 视频更新
功能介绍
媒资创建后，单独上传封面、更新视频文件或更新已有封面。
如果是更新视频文件，更新完后要通过确认媒资上传接口通知点播服务。
如果是更新封面或单独上传封面，则不需通知。
更新视频可以使用分段上传，具体方式可以参考示例2：媒资分段上传（20M以上）。
调试
您可以在API Explorer中调试该接口。
URI
PUT /v1.0/{project_id}/asset
表6-1 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目ID，获取方法请参考获取项 目ID
请求参数
表6-2 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 否 String 用户Token，使用Token鉴权方 式时必选。
通过调用IAM服务获取用户 Token接口获取（响应消息头中 X-Subject-Token的值）。
Authorization 否 String 使用AK/SK方式认证时必选，携 带的鉴权信息。
X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请 求的发生时间。
表6-3 请求 Body 参数
参数 是否必选 参数类型 描述
asset_id 是 String 媒资ID。
video_md5 否 String 视频文件MD5值。
建议参考媒资上传和更新生成对 应的MD5值。
video_name 否 String 视频文件名。
文件名后缀为可选。
video_type 否 String 视频文件类型。 取值为MP4、
TS、MOV、MXF、MPG、
FLV、WMV、AVI、M4V、
F4V、MPEG、3GP、ASF、
MKV cover_id 否 Integer 封面ID。
取值范围：[0,7]。
当前只支持一张封面，只能设置 为0。
参数 是否必选 参数类型 描述
cover_type 否 String 封面图片格式类型。
取值如下：
● JPG
● PNG
cover_md5 否 String 封面文件的MD5值。
subtitles 否 Array of Subtitle objects
字幕文件信息
表6-4 Subtitle
参数 是否必选 参数类型 描述
id 是 Integer 字幕id。
取值范围：[1,8]。
type 是 String 字幕文件类型，目前暂只支持
“SRT”。
language 是 String 字幕语音类型。
取值如下：
● CN：表示中文字幕。
● EN：表示英文字幕。
md5 否 String 字幕文件的MD5值。
description 否 String 字幕描述。
响应参数
状态码： 200
表6-5 响应 Body 参数
参数 参数类型 描述
asset_id String 媒资ID。
参数 参数类型 描述 video_upload_
url String 视频上传地址。
用于客户端上传不超过20MB的小视频文件
url String 封面上传地址，用于上传封面文件。
您可以使用PUT请求向“cover_upload_url”中
d_urls Array of
strings 字幕上传地址，用于上传字幕。
您可以使用PUT请求向“subtitle_upload_urls”
error_code String 错误码。
error_msg String 错误描述。
请求示例
PUT https://{endpoint}/v1.0/{project_id}/asset { "asset_id" : "f488337c31c8e4622f1590735b134c65", "cover_id" : "0",
"cover_type" : "JPG", "subtitles" : [ { "id" : 1,
"language" : "CN", "type" : "SRT",
"md5" : "SqcyFjJZoDZaP8oKIY6rgQ==", "description" : "AAAAA"
} ] }
响应示例
状态码： 200 处理成功返回。
{ "asset_id" : "f488337c31c8e4622f1590735b134c65",
"cover_upload_url" : "https://obs.cn-north-4.myhuaweicloud.com:443/obs-vod-1/%7Bproject_id%7D/
f488337c31c8e4622f1590735b134c65/cover/Cover0.jpg?
AWSAccessKeyId=CBN2JOVSQVVUREU0RCSN&Expires=1518148410&Signature=DVwzU6ejlKlSdAbwFXaSy67J puA%3D",
"subtitle_upload_urls" : [ "https://obs-vod-1.obs.cn-north-4.myhuaweicloud.com:
443/14ce1d4437164aba8b364ce15866154e/53a018d2dc53ca07eb5a07a839205c9d/subtitle/1.srt?
AWSAccessKeyId=CBN2JOVSQVVUREU0RCSN&Expires=1534760131&Signature=twZPabMSf%2FO
%2B2H3mpo3Gsqk1uIo%3D" ] }
状态码： 403 处理失败返回。
{ "error_code" : "VOD.10062",
"error_msg" : "Media asset or resource does not exist, please check."
}
状态码
状态码 描述
200 处理成功返回。
403 处理失败返回。
错误码
请参见错误码。