媒资处理-华为云

视频点播 VOD-视频更新:请求示例

请求示例更新媒资 PUT https://{endpoint}/v1.0/{project_id}/asset Content-Type: application/json { "asset_id": "f488337c31c8e4622f1590735b134c65", "cover_id": "0", "cover_type": "JPG", "subtitles": [ { "id": 1, "language": "CN", "type": "SRT", "md5": "SqcyFjJZoDZaP8oKIY6rgQ==", "description": "AAAAA" } ] }

视频点播 VOD 媒资处理

视频点播 VOD-视频更新:响应示例

响应示例状态码： 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=CBN2JOVSQVVUREU0R CS N&Expires=1518148410&Signature=DVwzU6ejlKlSdAbwFXaSy67JpuA%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." }

视频点播 VOD 媒资处理

视频点播 VOD-视频更新:请求参数

请求参数表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，仅支持查询，不支持修改。 video_md5 否 String 视频文件MD5值。建议参考《API参考》附录下生成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 字幕文件信息表4 Subtitle 参数是否必选参数类型描述 id 是 Integer 字幕id。取值范围：[1,16]。 type 是 String 字幕文件类型，目前暂只支持“SRT”和“VTT”。 language 是 String 字幕语言类型。 name 否 String 字幕文件名称。 md5 否 String 字幕文件的MD5值。 description 否 String 字幕描述。

视频点播 VOD 媒资处理

视频点播 VOD-视频更新:接口约束

接口约束视频更新接口只支持更新下载失败、已取消和上传失败状态的媒资请求Body参数的设置要求，如下所示：参数video_md5、video_name、video_type、cover_type、cover_md5、subtitles必须至少设置一个。如果更新视频，参数video_md5、video_name、video_type为必填项，不能为空值。如果更新封面，参数cover_id、cover_type、cover_md5为必填项，不能为空值。如果上传字幕文件，参数subtitles的id、type和language为必填项，不能为空值。如果未按照上述要求，正确设置参数，将无法正常返回接口响应消息。

视频点播 VOD 媒资处理

视频点播 VOD-创建审核媒资任务:响应示例

响应示例状态码： 200 处理成功返回。 { "asset_id" : "ede1391f8be15b4bcf99099c8d437c00", "review" : { "template_id" : "c80e56dadb8542e8a1b7c2224dd6733a", "interval" : 5, "politics" : 0, "terrorism" : 0, "porn" : 1 } } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10062", "error_msg" : "Media asset or resource does not exist, please check." }

视频点播 VOD 媒资处理

视频点播 VOD-创建审核媒资任务:请求示例

请求示例审核上传的媒资 POST https://{endpoint}/v1.0/{project_id}/asset/review Content-Type: application/json { "asset_id": "3e1cd21131a94525be55acf65888bf46", "review": { "template_id": "c80e56dadb8542e8a1b7c2224dd6733a" } }

视频点播 VOD 媒资处理

视频点播 VOD-创建审核媒资任务:请求参数

请求参数表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，仅支持查询，不支持修改。 review 是 Review object 媒资审核参数。说明：仅“华北-北京一”、“华北-北京四”点播服务支持此功能。表4 Review 参数是否必选参数类型描述 template_id 是 String 审核模板ID。您可以在视频点播控制台配置审核模板后获取，具体请参见《点播服务用户指南》中的“审核设置”。说明：仅“华北-北京一”、“华北-北京四”点播服务支持此功能。 interval 否 Integer 截图检测时间间隔，取值范围为[0,100]，该参数在请求参数中忽略。 politics 否 Integer 鉴政内容检测置信度，取值范围为[0,100]，该参数在请求参数中忽略。置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。 terrorism 否 Integer 鉴恐内容的检测置信度，取值范围为[0,100]，该参数在请求参数中忽略。置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。 porn 否 Integer 鉴黄内容的检测置信度，取值范围为[0,100]，该参数在请求参数中忽略。置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。

视频点播 VOD 媒资处理

视频点播 VOD-创建审核媒资任务:响应参数

响应参数状态码： 200 表5 响应Body参数参数参数类型描述 asset_id String VOD分配的媒资ID，仅支持查询，不支持修改。 review Review object 媒资审核参数。说明：仅“华北-北京一”、“华北-北京四”点播服务支持此功能。表6 Review 参数参数类型描述 template_id String 审核模板ID。您可以在视频点播控制台配置审核模板后获取，具体请参见《点播服务用户指南》中的“审核设置”。说明：仅“华北-北京一”、“华北-北京四”点播服务支持此功能。 interval Integer 截图检测时间间隔，取值范围为[0,100]，该参数在请求参数中忽略。 politics Integer 鉴政内容检测置信度，取值范围为[0,100]，该参数在请求参数中忽略。置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。 terrorism Integer 鉴恐内容的检测置信度，取值范围为[0,100]，该参数在请求参数中忽略。置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。 porn Integer 鉴黄内容的检测置信度，取值范围为[0,100]，该参数在请求参数中忽略。置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。状态码： 400 表7 响应Body参数参数参数类型描述 error_code String 错误码。 error_msg String 错误描述。

视频点播 VOD 媒资处理

视频点播 VOD-媒资处理:请求参数

请求参数表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，仅支持查询，不支持修改。 template_group_name 否 String 转码模板组名称。说明：若不为空，则使用指定的转码模板对上传的音视频进行转码，您可以在视频点播控制台配置转码模板，具体请参见《点播服务用户指南》中的“转码设置”。 auto_encrypt 否 Integer 是否自动加密。取值如下： 0：表示不加密。 1：表示需要加密。默认值：0。加密与转码必须要一起进行，当需要加密时，转码参数不能为空，且转码输出格式必须要为HLS。 thumbnail 否 Thumbnail object 截图参数 subtitle_id 否 Array of integers 字幕文件ID。说明：仅调用接口创建媒资：上传方式和视频更新，且设置请求参数“subtitles”时，该参数设置才生效。如果参数取值为空，默认选择最后一次上传的字幕压制至视频流中。视频流压制的字幕文件仅支持SRT格式。表4 Thumbnail 参数是否必选参数类型描述 type 是 String 截图类型。取值如下： time：每次进行截图的间隔时间。 dots: 按照指定的时间点截图。 quantity：按照指定张数，根据视频时长等分视频截图。 quantity 否 Integer type取值为quantity时必填。按照指定张数，根据视频时长等分视频截图。取值范围：[1,10]之间的整数。 quantity_time 否 Integer type取值为quantity时选填。按照指定时间间隔取指定张数截图。取值范围：[0,2147483647]之间的整数。 time 否 Integer 根据时间间隔采样时的时间间隔值。单位：秒。 type取值为time时。默认值：12 取值范围：[0,100]之间的整数。 dots 否 Array of integers type取值为dots时必填。指定时间截图时的时间点数组。 cover_position 否 Integer 该值表示指定第几张截图作为封面。默认值：1。 format 否 Integer 截图文件格式。取值如下： 1：jpg。默认值：1 。 aspect_ratio 否 Integer 纵横比，图像缩放方式。取值如下： 0：自适应（保持原有宽高比）。 1：16:9。默认值：0。 max_length 否 Integer 截图最长边的尺寸。单位：像素。宽边尺寸按照该尺寸与原始视频像素等比缩放计算。默认值：480。

视频点播 VOD 媒资处理

视频点播 VOD-媒资处理:请求示例

请求示例媒资转码处理 POST https://{endpoint}/v1.0/{project_id}/asset/process Content-Type: application/json { "asset_id": "b4f39691d66cc0ef75d62ee567146e11", "template_group_name": "test", "auto_encrypt": 0, "thumbnail": { "type": "time", "time": 12 }, "subtitle_id": [ 1 ] }

视频点播 VOD 媒资处理

云服务器内容精选

媒资处理

7*24

备案

专业服务

退订

建议反馈

售前咨询热线