视频点播 VOD-华为云

视频点播 VOD-修改转码模板:请求示例

请求示例修改转码模板 PUT https://{endpoint}/v2/{project_id}/asset/template/transcodings Content-Type: application/json { "group_id": "f9b045e0811c482f9de0d436a5927bb6", "name": "trans_template_test", "is_default": true, "quality_info_list": [ { "video": { "width": 1280, "height": 720, "bitrate": 1000, "quality": "HD", "frame_rate": 0 }, "audio": { "sample_rate": "AUDIO_SAMPLE_AUTO", "channels": "AUDIO_CHANNELS_1", "bitrate": 0 } } ], "watermark_template_ids": [], "common": { "pvc": false, "video_codec": "H264", "audio_codec": "AAC", "format": "HLS", "hls_interval": 5 } }

视频点播 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参数参数是否必选参数类型描述 group_id 是 String 模板组ID name 否 String 模板组名称 is_default 否 Boolean 是否是默认转码模板，默认false不设置为默认 is_auto_encrypt 否 Boolean 配置是否加密输出音视频，默认false不加密。当前只支持加密输出HLS格式的音视频流，不会对原始上传的音视频进行加密处理。非HLS转码输出的音视频格式，此字段不可配置。开启此配置前，请参考《VOD用户指南》的“HLS加密设置”章节获取密钥URL。 quality_info_list 是 Array of QualityInfoList objects 画质配置信息列表，如果不携带或者携带为空，则不更新模板中该部分数据。 watermark_template_ids 否 Array of strings 绑定的水印模板组ID数组 description 否 String 模板介绍 common 是 CommonInfo object 高清低码开关，编码格式多路共同参数表4 QualityInfoList 参数是否必选参数类型描述 video 否 VideoInfo object 模板视频信息。video和audio至少配置一个参数。 audio 否 AudioInfo object 模板音频信息表5 VideoInfo 参数是否必选参数类型描述 quality 是 String 画质 4K默认分辨率3840*2160，码率8000kbit/s 2K默认分辨率2560*1440，码率7000kbit/s FULL_HD默认分辨率1920*1080，码率3000kbit/s HD默认分辨率1280*720，码率1000kbit/s SD默认分辨率854*480，码率600kbit/s FLUENT默认分辨率480*270，码率300kbit/s width 否 Integer 视频宽度 height 否 Integer 视频高度 bitrate 是 Integer 码率，单位：kbit/s frame_rate 是 Integer 帧率，单位是帧每秒。取值范围：0或[5,60]之间的整数。默认为0，0代表自适应。表6 AudioInfo 参数是否必选参数类型描述 sample_rate 是 String 音频采样率（有效值范围） AUDIO_SAMPLE_AUTO (default), AUDIO_SAMPLE_22050：22050Hz AUDIO_SAMPLE_32000：32000Hz AUDIO_SAMPLE_44100：44100Hz AUDIO_SAMPLE_48000：48000Hz AUDIO_SAMPLE_96000：96000Hz bitrate 否 Integer 音频码率（单位：Kbps） channels 是 String 声道数（有效值范围） AUDIO_CHANNELS_1:单声道 AUDIO_CHANNELS_2：双声道 AUDIO_CHANNELS_5_1：5.1声道表7 CommonInfo 参数是否必选参数类型描述 pvc 是 Boolean 高清低码开关 video_codec 是 String 视频编码格式 audio_codec 否 String 音频编码格式 AAC：AAC格式 (default) HEAAC1：HEAAC1格式 HEAAC2：HEAAC2格式 MP3：MP3格式 is_black_cut 否 Boolean 黑边剪裁类型，默认false不开启黑边剪裁 format 是 String 格式 hls_interval 是 Integer 分片时长，范围2-10（默认为5秒） upsample 否 Boolean 开启后可以提升视频的分辨率，增加采样点的数量。 adaptation 否 String 转码后的片源分辨率自适应方式。取值如下： SHORT：短边自适应。转码模板的宽和高都设置，用其中的短边与片源短边对比，然后片源长边按此比例进行缩放。 LONG：长边自适应。转码模板的宽和高都设置，用其中的长边与片源长边对比，然后片源短边按此比例进行缩放。 NONE：按设置宽高适应，为默认值。按照转码模板设置的宽高输出。说明： V1接口（已废弃）不支持设置该参数，默认按SHORT处理。V2接口默认按NONE处理，V1和V2接口默认值有差异，在调用时需要注意该参数值的设置。控制台是通过V2接口创建的转码模板，实际与V1接口创建转码模板的默认值保持一致，为SHORT。 preset 否 Integer 编码质量等级，取值[0,2] 0表示默认方式，1表示转码效率优先，2表示转码质量优先。 max_iframes_interval 否 Integer I帧最大间隔，取值范围：[2，10]。默认值：5，单位秒。 hls_audio_separate 否 Boolean 转码后音频是否独立存储。

视频点播 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 处理成功返回。 { "asset_id" : "06da0367af8f297ea3efc791e8b27157", "edk" : "02009800f00446c3aa6ad610bb121a602fa3091daca7a544ded4f514cae2c233cf51f3d88de64712242a8468042db19b4282e0d7196a8d4df6150169debb5d077527fad983e14174f1ab5430958ca4903187321f0a3406284bf938b64de95ddd3db438df9ddae98d347058969fd39be5049a0a5830396432303366352d313235362d346265322d626539642d38313164333363336630353200000000f9776c60d33706c68195bc64934f94ee28fbfdf03e5fbb65c5450599d6aa4807", "dk" : "4Q9KYgKbUChxocNYbteP3A==" } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10101", "error_msg" : "Unable to get the key because there is no encryption." }

视频点播 VOD 密钥查询

视频点播 VOD-查询转码模板列表:响应示例

响应示例状态码： 200 处理成功返回。 { "template_group_list" : [ { "group_id" : "9751249d25f14587b212544d6fd8dcf8", "name" : "non_transcoding_template_group", "is_default" : false, "type" : "non_transcoding_template_group", "is_auto_encrypt" : false, "quality_info_list" : [ { "video" : { "quality" : "UNKNOW", "width" : 0, "height" : 0, "bitrate" : 0, "frame_rate" : 0 }, "audio" : null } ], "watermark_template_ids" : null, "description" : null, "common" : { "pvc" : false, "is_black_cut" : false, "format" : "UNKNOW", "upsample" : false, "adaptation" : "NONE", "video_codec" : null, "audio_codec" : "AAC", "hls_interval" : 0 } } ], "total" : 0 } 状态码： 403 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

视频点播 VOD

视频点播 VOD-查询转码模板列表:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 template_group_list Array of TransTemplateRsp objects 模板组信息 total Integer 总记录条数表5 TransTemplateRsp 参数参数类型描述 group_id String 模板组id name String 模板组名称 is_default Boolean 是否设置成默认转码模板 type String 模板组类型 is_auto_encrypt Boolean 配置是否加密输出音视频，默认false不加密。当前只支持加密输出HLS格式的音视频流，不会对原始上传的音视频进行加密处理。非HLS转码输出的音视频格式，此字段不可配置。开启此配置前，请参考《VOD用户指南》的“HLS加密设置”章节获取密钥URL。 quality_info_list Array of QualityInfoList objects 画质配置信息列表 watermark_template_ids Array of strings 绑定的水印模板组ID数组 description String 模板介绍 common CommonInfo object 高清低码开关，高清低码Version，编码格式多路共同参数表6 QualityInfoList 参数参数类型描述 video VideoInfo object 模板视频信息。video和audio至少配置一个参数。 audio AudioInfo object 模板音频信息表7 VideoInfo 参数参数类型描述 quality String 画质 4K默认分辨率3840*2160，码率8000kbit/s 2K默认分辨率2560*1440，码率7000kbit/s FULL_HD默认分辨率1920*1080，码率3000kbit/s HD默认分辨率1280*720，码率1000kbit/s SD默认分辨率854*480，码率600kbit/s FLUENT默认分辨率480*270，码率300kbit/s width Integer 视频宽度 height Integer 视频高度 bitrate Integer 码率，单位：kbit/s frame_rate Integer 帧率，单位是帧每秒。取值范围：0或[5,60]之间的整数。默认为0，0代表自适应。表8 AudioInfo 参数参数类型描述 sample_rate String 音频采样率（有效值范围） AUDIO_SAMPLE_AUTO (default), AUDIO_SAMPLE_22050：22050Hz AUDIO_SAMPLE_32000：32000Hz AUDIO_SAMPLE_44100：44100Hz AUDIO_SAMPLE_48000：48000Hz AUDIO_SAMPLE_96000：96000Hz bitrate Integer 音频码率（单位：Kbps） channels String 声道数（有效值范围） AUDIO_CHANNELS_1:单声道 AUDIO_CHANNELS_2：双声道 AUDIO_CHANNELS_5_1：5.1声道表9 CommonInfo 参数参数类型描述 pvc Boolean 高清低码开关 video_codec String 视频编码格式 audio_codec String 音频编码格式 AAC：AAC格式 (default) HEAAC1：HEAAC1格式 HEAAC2：HEAAC2格式 MP3：MP3格式 is_black_cut Boolean 黑边剪裁类型，默认false不开启黑边剪裁 format String 格式 hls_interval Integer 分片时长，范围2-10（默认为5秒） upsample Boolean 开启后可以提升视频的分辨率，增加采样点的数量。 adaptation String 转码后的片源分辨率自适应方式。取值如下： SHORT：短边自适应。转码模板的宽和高都设置，用其中的短边与片源短边对比，然后片源长边按此比例进行缩放。 LONG：长边自适应。转码模板的宽和高都设置，用其中的长边与片源长边对比，然后片源短边按此比例进行缩放。 NONE：按设置宽高适应，为默认值。按照转码模板设置的宽高输出。说明： V1接口（已废弃）不支持设置该参数，默认按SHORT处理。V2接口默认按NONE处理，V1和V2接口默认值有差异，在调用时需要注意该参数值的设置。控制台是通过V2接口创建的转码模板，实际与V1接口创建转码模板的默认值保持一致，为SHORT。 preset Integer 编码质量等级，取值[0,2] 0表示默认方式，1表示转码效率优先，2表示转码质量优先。 max_iframes_interval Integer I帧最大间隔，取值范围：[2，10]。默认值：5，单位秒。 hls_audio_separate Boolean 转码后音频是否独立存储。状态码： 403 表10 响应Body参数参数参数类型描述 error_code String 错误码。 error_msg String 错误描述。

视频点播 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-查询转码模板列表:URI

URI GET /v2/{project_id}/asset/template/transcodings 表1 路径参数参数是否必选参数类型描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数参数是否必选参数类型描述 group_id 否 String 模板id is_default 否 Boolean 是否默认模板 offset 否 Integer 偏移量。默认为0。指定group_id时该参数无效。 limit 否 Integer 每页记录数。默认为10，范围[1,100]。指定group_id时该参数无效。 query_string 否 String 按照模板名和描述模糊查询。指定group_id时该参数无效。

视频点播 VOD

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

URI GET /v1.1/{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进行初始段后OBS返回的。除上传任务初始化场景外，该字段必填。 part_number 否 Integer 上传段时每一段的id。取值范围：[1,10000]。

视频点播 VOD 媒资上传

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

响应示例状态码： 200 处理成功返回。 { "sign_str" : "https://obs.cn-north-4.myhuaweicloud.com:443/obs-vod-1/%7Bproject_id%7D/f488337c31c8e4622f1590735b134c65/Avatar_480P.mp4?AWSAccessKeyId=CBN2JOVSQVVUREU0R CS N&Expires=1518147618&Signature=kZYh0hEos2VJhjjdHC2zVAHGyXA%3D" } 状态码： 403 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

视频点播 VOD 媒资上传

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

请求示例初始化上传任务： GET https://{endpoint}/v1.1/{project_id}/asset/authority?http_verb=POST&content_type={type}&bucket={bucket}&object_key={objectKey} 上传段： GET https://{endpoint}/v1.1/{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.1/{project_id}/asset/authority?http_verb=POST&upload_id={id}&bucket={bucket}&object_key={objectKey} 取消段： GET https://{endpoint}/v1.1/{project_id}/asset/authority?http_verb=DELETE&bucket={bucket}&object_key={objectKey}&upload_id={uploadId} 列举已上传的段： GET https://{endpoint}/v1.1/{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 带授权签名字符串的URL。具体调用示例请参见示例2：媒资分段上传（20M以上）。示例：https://{obs_domain}/{bucket}?AWSAccessKeyId={AccessKeyID}&Expires={ExpiresValue}&Signature={Signature} 状态码： 403 表5 响应Body参数参数参数类型描述 error_code String 错误码。 error_msg String 错误描述。

视频点播 VOD 媒资上传

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

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

视频点播 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参数参数是否必选参数类型描述 name 是 String 模板组名称 is_default 否 Boolean 是否设置成默认转码模板，默认false不设置为默认 is_auto_encrypt 否 Boolean 配置是否加密输出音视频，默认false不加密。当前只支持加密输出HLS格式的音视频流，不会对原始上传的音视频进行加密处理。非HLS转码输出的音视频格式，此字段不可配置。开启此配置前，请参考《VOD用户指南》的“HLS加密设置”章节获取密钥URL。 quality_info_list 是 Array of QualityInfoList objects 画质配置信息列表 common 是 CommonInfo object 高清低码开关，编码格式多路共同参数 watermark_template_ids 否 Array of strings 绑定的水印模板组ID数组 description 否 String 模板介绍表4 QualityInfoList 参数是否必选参数类型描述 video 否 VideoInfo object 模板视频信息。video和audio至少配置一个参数。 audio 否 AudioInfo object 模板音频信息表5 VideoInfo 参数是否必选参数类型描述 quality 是 String 画质 4K默认分辨率3840*2160，码率8000kbit/s 2K默认分辨率2560*1440，码率7000kbit/s FULL_HD默认分辨率1920*1080，码率3000kbit/s HD默认分辨率1280*720，码率1000kbit/s SD默认分辨率854*480，码率600kbit/s FLUENT默认分辨率480*270，码率300kbit/s width 否 Integer 视频宽度 height 否 Integer 视频高度 bitrate 是 Integer 码率，单位：kbit/s frame_rate 是 Integer 帧率，单位是帧每秒。取值范围：0或[5,60]之间的整数。默认为0，0代表自适应。表6 AudioInfo 参数是否必选参数类型描述 sample_rate 是 String 音频采样率（有效值范围） AUDIO_SAMPLE_AUTO (default), AUDIO_SAMPLE_22050：22050Hz AUDIO_SAMPLE_32000：32000Hz AUDIO_SAMPLE_44100：44100Hz AUDIO_SAMPLE_48000：48000Hz AUDIO_SAMPLE_96000：96000Hz bitrate 否 Integer 音频码率（单位：Kbps） channels 是 String 声道数（有效值范围） AUDIO_CHANNELS_1:单声道 AUDIO_CHANNELS_2：双声道 AUDIO_CHANNELS_5_1：5.1声道表7 CommonInfo 参数是否必选参数类型描述 pvc 是 Boolean 高清低码开关 video_codec 是 String 视频编码格式 audio_codec 否 String 音频编码格式 AAC：AAC格式 (default) HEAAC1：HEAAC1格式 HEAAC2：HEAAC2格式 MP3：MP3格式 is_black_cut 否 Boolean 黑边剪裁类型，默认false不开启黑边剪裁 format 是 String 格式 hls_interval 是 Integer 分片时长，范围2-10（默认为5秒） upsample 否 Boolean 开启后可以提升视频的分辨率，增加采样点的数量。 adaptation 否 String 转码后的片源分辨率自适应方式。取值如下： SHORT：短边自适应。转码模板的宽和高都设置，用其中的短边与片源短边对比，然后片源长边按此比例进行缩放。 LONG：长边自适应。转码模板的宽和高都设置，用其中的长边与片源长边对比，然后片源短边按此比例进行缩放。 NONE：按设置宽高适应，为默认值。按照转码模板设置的宽高输出。说明： V1接口（已废弃）不支持设置该参数，默认按SHORT处理。V2接口默认按NONE处理，V1和V2接口默认值有差异，在调用时需要注意该参数值的设置。控制台是通过V2接口创建的转码模板，实际与V1接口创建转码模板的默认值保持一致，为SHORT。 preset 否 Integer 编码质量等级，取值[0,2] 0表示默认方式，1表示转码效率优先，2表示转码质量优先。 max_iframes_interval 否 Integer I帧最大间隔，取值范围：[2，10]。默认值：5，单位秒。 hls_audio_separate 否 Boolean 转码后音频是否独立存储。

视频点播 VOD 转码模板管理

云服务器内容精选

视频点播 VOD

7*24

备案

专业服务

退订

建议反馈

售前咨询热线