媒资上传-华为云

视频点播 VOD-创建媒资：URL拉取注入（公测中）:请求示例

请求示例创建媒资，使用URL拉取方式。基于音视频源文件URL，将音视频文件离线拉取上传到点播服务 POST https://{endpoint}/v1.0/{project_id}/asset/upload_by_url Content-Type: application/json { "upload_metadatas": [ { "url": "https://mpc-test.obs.cn-north-4.myhuaweicloud.com/Avatar_480P.mp4", "title": "Avatar test test", "video_type": "MP4", "description": "Avatar, test", "category_id": 1, "tags": "mytags", "auto_publish": 1 }, { "url": "https://mpc-test.obs.cn-north-4.myhuaweicloud.com/Avatar_720.mp4", "title": "Avatar test test", "video_type": "MP4", "description": "Avatar, test", "category_id": 1, "tags": "mytags", "auto_publish": 1 } ] }

视频点播 VOD 媒资上传

视频点播 VOD-创建媒资：URL拉取注入（公测中）:响应参数

响应参数状态码： 200 表7 响应Body参数参数参数类型描述 upload_assets Array of UploadAsset objects 待拉取创建的媒资元数据表8 UploadAsset 参数参数类型描述 url String 待拉取音视频文件的URL。 asset_id String 新创建媒资的媒资id error_code String 错误码。 error_msg String 错误描述。状态码： 400 表9 响应Body参数参数参数类型描述 error_code String 错误码。 error_msg String 错误描述。

视频点播 VOD 媒资上传

视频点播 VOD-创建媒资：URL拉取注入（公测中）:响应示例

响应示例状态码： 200 处理成功返回。 { "upload_assets" : [ { "url" : "https://mpc-test.obs.cn-north-4.myhuaweicloud.com/Avatar_480P.mp4", "asset_id" : "f488337c31c8e4622f1590735b134c65", "error_code" : null, "error_msg" : null }, { "url" : "https://mpc-test.obs.cn-north-4.myhuaweicloud.com/Avatar_720.mp4", "asset_id" : "f488337c31c8e4622f1590525b134c65", "error_code" : null, "error_msg" : null } ] } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10003", "error_msg" : "The specified key does not exist." }

视频点播 VOD 媒资上传

视频点播 VOD-创建媒资：URL拉取注入（公测中）:请求参数

请求参数表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参数参数是否必选参数类型描述 upload_metadatas 是 Array of UploadMetaDataByUrl objects 待拉取创建的媒资元数据表4 UploadMetaDataByUrl 参数是否必选参数类型描述 video_type 是 String 上传音视频文件的格式。取值如下：视频文件：MP4、TS、MOV、MXF、MPG、FLV、WMV、AVI、M4V、F4V、MPEG、3GP、ASF、MKV、WEBM、M3U8 音频文件：MP3、OGG、WAV、WMA、APE、FLAC、AAC、AC3、MMF、AMR、M4A、M4R、WV、MP2 若上传格式为音频文件，则不支持转码、添加水印和字幕。 title 是 String 媒资标题，长度不超过128个字节，UTF-8编码。 url 是 String 待拉取音视频文件的URL。说明： URL必须以扩展名结尾，暂只支持http和https协议，其中HTTP方式存在安全风险，建议使用HTTPS。不建议您将认证凭据等敏感信息写在URL。 description 否 String 视频描述，长度不超过1024个字节。 category_id 否 Integer 媒资分类ID。您可以调用创建媒资分类接口或在点播控制台的分类设置中创建对应的媒资分类，并获取分类ID。说明：若不设置或者设置为-1，则上传的音视频归类到系统预置的“其它”分类中。 tags 否 String 视频标签。单个标签不超过24个字节，最多不超过16个标签。多个用逗号分隔，UTF8编码。 auto_publish 否 Integer 是否自动发布。取值如下： 0：表示不自动发布。 1：表示自动发布。默认值：1。 template_group_name 否 String 转码模板组名称。若不为空，则使用指定的转码模板对上传的音视频进行转码，您可以在视频点播控制台配置转码模板，具体请参见《点播服务用户指南》中的“转码设置”。说明：若同时设置了“template_group_name”和“workflow_name”字段，则“template_group_name”字段生效。 auto_encrypt 否 Integer 是否自动加密。取值如下： 0：表示不加密。 1：表示需要加密。默认值：0。若设置为需要加密，则必须配置转码模板，且转码的输出格式是HLS。 auto_preheat 否 Integer 是否自动预热到CDN。取值如下： 0：表示不自动预热。 1：表示自动预热。默认值：0。 thumbnail 否 Thumbnail object 截图参数 review 否 Review object 媒资审核参数。说明：仅“华北-北京一”、“华北-北京四”点播服务支持此功能。 workflow_name 否 String 工作流名称。若不为空，则使用指定的工作流对上传的音视频进行处理，您可以在视频点播控制台配置工作流，具体请参见《点播服务用户指南》中的“工作流设置”。表5 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。表6 Review 参数是否必选参数类型描述 template_id 否 String 审核模板ID。您可以在视频点播控制台配置审核模板后获取，具体请参见《点播服务用户指南》中的“审核设置”。说明：仅“华北-北京一”、“华北-北京四”点播服务支持此功能。 interval 否 Integer 截图检测时间间隔，取值范围为(0,100]，该参数在请求参数中忽略。 politics 否 Integer 鉴政内容检测置信度，取值范围为-1或者[0,100]，该参数在请求参数中忽略。置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。politics、terrorism、porn三个参数不能同时为0。 terrorism 否 Integer 鉴恐内容的检测置信度，取值范围为-1或者[0,100]，该参数在请求参数中忽略。置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。politics、terrorism、porn三个参数不能同时为0。 porn 否 Integer 鉴黄内容的检测置信度，取值范围为-1或者[0,100]，该参数在请求参数中忽略。置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。politics、terrorism、porn三个参数不能同时为0。

视频点播 VOD 媒资上传

视频点播 VOD-创建媒资：上传方式:响应参数

响应参数状态码： 200 表7 响应Body参数参数参数类型描述 asset_id String 媒体ID video_upload_url String 视频上传URL cover_upload_url String 封面上传地址 subtitle_upload_urls Array of strings 字幕文件上传url数组 target File_addr object 媒资存储参数信息。查询接口，仅媒资为托管时有返回值。表8 File_addr 参数参数类型描述 bucket String OBS的bucket名称。 location String 桶所在的区域名，如“华北-北京四”的区域名为“cn-north-4”，创建的桶所在区域必须和点播服务所在区域保持一致。 object String 文件的存储路径。状态码： 403 表9 响应Body参数参数参数类型描述 error_code String 错误码。 error_msg String 错误描述。

视频点播 VOD 媒资上传

视频点播 VOD-创建媒资：上传方式:响应示例

响应示例状态码： 200 处理成功返回。 { "asset_id" : "f488337c31c8e4622f1590735b134c65", "video_upload_url" : "https://obs.cn-north-4.myhuaweicloud.com:443/obs-vod-1/%7Bproject_id%7D/f488337c31c8e4622f1590735b134c65/Avatar_480P.mp4?AWSAccessKeyId=CBN2J**********0R CS N&Expires=1518147618&Signature=kZYh0hEos2V**********AHGyXA%3D", "cover_upload_url" : "https://obs.cn-north-4.myhuaweicloud.com:443/obs-vod-1/%7Bproject_id%7D/f488337c31c8e4622f1590735b134c65/cover/Cover0.jpg?AWSAccessKeyId=CBN2J**********0RCSN&Expires=1518147619&Signature=kZYh0hEos2V**********AHGyXA%3D", "subtitle_upload_urls" : [ "https://obs-vod-1.obs.cn-north-4.myhuaweicloud.com:443/14ce1d4437164aba8b364ce15866154e/53a018d2dc53ca07eb5a07a839205c9d/subtitle/1.srt?AWSAccessKeyId=CBN2J**********0RCSN&Expires=1534760131&Signature=kZYh0hEos2V**********AHGyXA%3D" ], "target" : { "bucket" : "obs-vod-1", "location" : "cn-north-4", "object" : "093bb6b6c4fc460ab90a40d8b821dda3/a2053aef99725711dad3e02dc6cd5f89/0a9b70035b78b8a19c6d9e7c2693d93c.mp4" } } 状态码： 403 处理失败返回。 { "error_code" : "VOD.10064", "error_msg" : "Media asset classification 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参数参数是否必选参数类型描述 title 是 String 媒资标题，长度不超过128个字节，UTF-8编码。 description 否 String 视频描述，长度不超过1024个字节。 video_name 是 String 音视频文件名，长度不超过128个字节。文件名后缀可选。 video_type 是 String 上传音视频文件的格式。取值如下：视频文件：MP4、TS、MOV、MXF、MPG、FLV、WMV、AVI、M4V、F4V、MPEG、3GP、ASF、MKV、WEBM 音频文件：MP3、OGG、WAV、WMA、APE、FLAC、AAC、AC3、MMF、AMR、M4A、M4R、WV、MP2 若上传格式为音频文件，则不支持转码、添加水印和字幕。 category_id 否 Integer 媒资分类ID。您可以调用创建媒资分类接口或在点播控制台的分类设置中创建对应的媒资分类，并获取分类ID。说明：若不设置或者设置为-1，则上传的音视频归类到系统预置的“其它”分类中。 video_md5 否 String 建议参考《API参考》附录下生成MD5值的媒资上传和更新示例。 cover_type 否 String 封面图片文件类型。取值如下： JPG PNG 上传后的封面名称是固定的，后缀名为封面类型缩写。例如cover0.jpg，cover1.png 若不指定类型，则封面文件无后缀名。说明：如果设置了图片格式，则不会执行首帧截图作为封面动作，需自行上传封面。 cover_md5 否 String 封面图片文件MD5值。建议参考《API参考》附录下生成MD5值的媒资上传和更新示例。 subtitles 否 Array of Subtitle objects 字幕文件信息 tags 否 String 视频标签。单个标签不超过24个字节，最多不超过16个标签。多个用逗号分隔，UTF8编码。 auto_publish 否 Integer 是否自动发布。取值如下： 0：表示不自动发布。 1：表示自动发布。默认值：1。 template_group_name 否 String 转码模板组名称。若不为空，则使用指定的转码模板对上传的音视频进行转码，您可以在视频点播控制台配置转码模板，具体请参见《点播服务用户指南》中的“转码设置”。说明：若同时设置了“template_group_name”和“workflow_name”字段，则“template_group_name”字段生效。 auto_encrypt 否 Integer 是否自动加密。取值如下： 0：表示不加密。 1：表示需要加密。默认值：0。加密与转码必须要一起进行，当需要加密时，转码参数不能为空，且转码输出格式必须要为HLS。 auto_preheat 否 String 是否自动预热到CDN。取值如下： 0：表示不自动预热。 1：表示自动预热。默认值：0。 thumbnail 否 Thumbnail object 截图参数 review 否 Review object 媒资审核参数。说明：仅“华北-北京一”、“华北-北京四”点播服务支持此功能。 workflow_name 否 String 工作流名称。若不为空，则使用指定的工作流对上传的音视频进行处理，您可以在视频点播控制台配置工作流，具体请参见《点播服务用户指南》中的“工作流设置”。表4 Subtitle 参数是否必选参数类型描述 id 是 Integer 字幕id。取值范围：[1,16]。 type 是 String 字幕文件类型，目前暂只支持“SRT”和“VTT”。 language 是 String 字幕语言类型。 name 否 String 字幕文件名称。 md5 否 String 字幕文件的MD5值。 description 否 String 字幕描述。表5 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。表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时，表示未进行此项检测。

视频点播 VOD 媒资上传

视频点播 VOD-创建媒资：上传方式:请求示例

请求示例创建媒资 POST https://{endpoint}/v1/{project_id}/asset Content-Type: application/json { "title": "Avatar test test", "description": "Avatar, test", "category_id": -1, "tags": "mytags", "video_name": "Avatar_480P.mp4", "video_type": "MP4", "video_md5": "a945d4b3d8fc317190a9332fe856f03d", "cover_type": "JPG", "cover_md5": "a655d4b3d8fc758691a9332fe387f26c", "auto_publish": 0, "subtitles": [ { "id": 1, "language": "CN", "type": "SRT", "md5": "SqcyFjJZoDZaP8oKIY6rgQ==", "description": "AAAAA" } ] }

视频点播 VOD 媒资上传

视频点播 VOD-获取分段上传授权:请求示例

请求示例初始化上传任务： GET https://{endpoint}/v1.0/{project_id}/asset/authority?http_verb=POST&content_type={type}&bucket={bucket}&object_key={objectKey} 上传段： GET https://{endpoint}/v1.0/{project_id}/asset/authority?http_verb=PUT&content_md5={md5}&part_number={num}&upload_id={id}&bucket={bucket}&object_key={objectKey} 合并段： GET https://{endpoint}/v1.0/{project_id}/asset/authority?http_verb=POST&upload_id={id}&bucket={bucket}&object_key={objectKey} 取消段： GET https://{endpoint}/v1.0/{project_id}/asset/authority?http_verb=DELETE&bucket={bucket}&object_key={objectKey}&upload_id={uploadId} 列举已上传的段： GET https://{endpoint}/v1.0/{project_id}/asset/authority?http_verb=GET&bucket={bucket}&object_key={objectKey}&upload_id={uploadId}

视频点播 VOD 媒资上传

视频点播 VOD-获取分段上传授权:请求参数

请求参数表3 请求Header参数参数是否必选参数类型描述 X-Auth-Token 否 String 用户Token，使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。

视频点播 VOD 媒资上传

视频点播 VOD-获取分段上传授权:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 sign_str String 授权签名字符串。示例：AWSAccessKeyId={AccessKeyID}&Expires={ExpiresValue}&Signature={Signature} 状态码： 403 表5 响应Body参数参数参数类型描述 error_code String 错误码。 error_msg String 错误描述。

视频点播 VOD 媒资上传

视频点播 VOD-获取分段上传授权:URI

URI GET /v1.0/{project_id}/asset/authority 表1 路径参数参数是否必选参数类型描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数参数是否必选参数类型描述 http_verb 是 String 分段上传时调用OBS接口的HTTP方法，具体操作需要的HTTP方法请参考OBS的接口文档。初始化上传任务：POST 上传段：PUT 合并段：POST 取消段：DELETE 列举已上传段：GET bucket 是 String 桶名。调用创建媒资：上传方式接口中返回的响应体中的target字段获得的bucket值。 object_key 是 String 对象名。调用创建媒资：上传方式接口中返回的响应体中的target字段获得的object值。 content_type 否 String 文件类型对应的content-type，当为上传任务初始化场景该字段必填。参数填写可参考媒资分段上传（20M以上）。视频文件：video/视频格式，如：“video/mp4” 音频文件：audio/音频格式，如：“audio/mp3” 图片文件：image/图片格式，如：“image/png” 字幕文件：application/octet-stream content_md5 否 String 上传段时每段的MD5。 upload_id 否 String 每一个上传任务的id，是OBS初始化视频分段上传任务后返回的值。除上传任务初始化场景外，该字段必填。 part_number 否 Integer 上传段时每一段的id。取值范围：[1,10000]。

视频点播 VOD 媒资上传

视频点播 VOD-获取分段上传授权:功能介绍

功能介绍客户端请求创建媒资时，如果媒资文件超过20MB，需采用分段的方式向OBS上传，在每次与OBS交互前，客户端需通过此接口获取到授权方可与OBS交互。该接口可以获取初始化多段上传任务、上传段、合并段、列举已上传段、取消段合并的带有临时授权的URL，用户需要根据OBS的接口文档配置相应请求的HTTP请求方法、请求头、请求体，然后请求对应的带有临时授权的URL。视频分段上传方式和OBS的接口文档保持一致，包括HTTP请求方法、请求头、请求体等各种入参，此接口的作用是为用户生成鉴权信息（鉴权信息即sign_str），用来替换OBS接口中对应的URL，临时给用户开通向点播服务的桶上传文件的权限。调用获取授权接口时需要传入bucket、object_key、http_verb，其中bucket和object_key是由创建媒资：上传方式接口中返回的响应体中的target字段获得的bucket和object，http_verb需要根据指定的操作选择。

视频点播 VOD 媒资上传

云服务器内容精选

媒资上传

7*24

备案

专业服务

退订

建议反馈

售前咨询热线