华为云用户手册

请求示例 DELETE https://{endpoint}/v1/{project_id}/asset/transcode-product Content-Type: application/json { "asset_id": "8c53b4038ea3d8694f1a8a7ac95f612f", "delete_type": "PRODUCT", "delete_infos": [ { "group_id": "9171008cca7f47909c61f61a65d4c906", "products": [ { "url": "https://103-cn-north-4.cdn-vod.huaweicloud.com/asset/8c53b4038ea3d8694f1a8a7ac95f612f/play_multi_video/9171008cca7f47909c61f61a65d4c906/38a92b74ead764ad21aa5355bad5193e.mp4" } ] } ] } DELETE https://{endpoint}/v1/{project_id}/asset/transcode-product Content-Type: application/json { "asset_id": "6f306b4cc58c39b2a97ad797367b88ad", "delete_type": "GROUP", "delete_infos": [ { "group_id": "02e6887dd6bf48299922eec52d192115" } ] }

响应示例 状态码： 200 处理成功返回。 { "status" : "SUC CES S", "deleted_products" : [ { "group_id" : "9171008cca7f47909c61f61a65d4c906", "products" : [ { "url" : "https://103-cn-north-4.cdn-vod.huaweicloud.com/asset/8c53b4038ea3d8694f1a8a7ac95f612f/play_multi_video/9171008cca7f47909c61f61a65d4c906/da6613ac132eda54b2f4ab67adbf56bd.mp4" } ] } ], "failed_products" : [ ] } 状态码： 403 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

请求参数 表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 媒资ID。 delete_type 否 String GROUP：模板组级删除。 PRODUCT：产物级删除 delete_infos 否 Array of ProductGroupInfo objects 删除的产物信息，最多传100个产物信息。 表4 ProductGroupInfo 参数 是否必选 参数类型 描述 group_id 否 String 模板组ID products 否 Array of ProductUrlInfo objects 产物信息 表5 ProductUrlInfo 参数 是否必选 参数类型 描述 url 否 String 删除的产物URL

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 asset_id String VOD分配的媒资ID，仅支持查询，不支持修改。 status String SUCCESS：成功 FAIL：失败 PARTIAL_SUCCESS：部分成功 deleted_products Array of ProductGroupInfo objects 删除成功的产物 failed_products Array of ProductGroupDelFailInfo objects 删除失败的产物 表7 ProductGroupInfo 参数 参数类型 描述 group_id String 模板组ID products Array of ProductUrlInfo objects 产物信息 表8 ProductUrlInfo 参数 参数类型 描述 url String 删除的产物URL 表9 ProductGroupDelFailInfo 参数 参数类型 描述 group_id String 模板组ID fail_reason String 模板组删除失败的原因 products Array of ProductDelFailInfo objects 删除失败的产物的信息 表10 ProductDelFailInfo 参数 参数类型 描述 url String 删除产物的URL fail_reason String 删除产物失败的原因 状态码： 403 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

URI DELETE /v1.0/{project_id}/asset 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 asset_id 是 Array of strings 媒资ID，支持一次删除多个媒资，批量删除时以逗号分隔。取值范围[1,10]。 delete_type 否 String 删除类型，当值为origin时只删除源文件，保留转码后文件，不填的话走默认删除整个媒资。

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

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 delete_result_array Array of DeleteResult objects 删除媒资任务的处理结果。 表5 DeleteResult 参数 参数类型 描述 asset_id String VOD分配的媒资ID，仅支持查询，不支持修改。 status String 删除状态。 取值如下： DELETED：已删除。 FAILED：删除失败。 状态码： 403 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应示例 状态码： 200 处理成功返回。 { "delete_result_array" : [ { "asset_id" : "f488337c31c8e4622f1590735b134c65", "status" : "DELETED" } ] } 状态码： 403 处理失败返回。 { "error_code" : "VOD.10062", "error_msg" : "Media asset or resource does not exist, please check." }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total Integer 日志总数。 logs Array of CdnLog objects 日志列表数据。 表5 CdnLog 参数 参数类型 描述 domain_name String 域名 名称。 start_time String 查询起始时间。 end_time String 查询结束时间。 name String 日志名称。 size Long 日志大小。 单位：byte。 link String 日志下载链接。 日志文件中的字段说明请参见日志管理。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应示例 状态码： 200 处理成功返回。 { "total" : 1, "logs" : [ { "domain_name" : "1866.cdn-vod.huaweicloud.com", "start_time" : "2021-12-23 23:00:00", "end_time" : "2021-12-24 00:00:00", "name" : "2021122323-1866.cdn-vod.huaweicloud.com-cn.gz", "size" : 225, "link" : "http://cdn-log-user-bj4.obs.cn-north-4.myhuaweicloud.com:80/mainland/20211223/23/2021122323-1866.cdn-vod.huaweicloud.com-cn.gz?AccessKeyId=AOV5GWALBMNTLIYDEQLV&Expires=1641433717&response-content-disposition=attachment%3Bfilename%3D%222021122323-1866.cdn-vod.huaweicloud.com-cn.gz%22&Signature=kZYh0hEos2V**********AHGyXA%3D" } ] } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

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

URI GET /v1.0/{project_id}/vod/cdn/logs 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 domain_name 是 String 加速域名，参考格式：www.test1.com。 query_date 是 String 查询开始时间，格式为yyyyMMddHHmmss。 查询结果为开始时间之后24小时内的日志数据 只能查最近一个月内的数据 page_size 否 Integer 每页显示日志数量。取值范围为[1,10000]，默认值：10000。 page_number 否 Integer 当前页数。取值范围为[1,65535]，默认值：1。

响应示例 状态码： 200 处理成功返回。 { "template_group_collection_list" : [ { "group_collection_id" : "9751249d25f14587b212544d6fd8dcf8", "name" : "test", "template_group_list" : [ { "group_id" : "9751249d25f14587b212544d6fd8dcf8", "name" : "test112", "status" : "0", "type" : "custom_template_group", "auto_encrypt" : 0, "quality_info_list" : [ { "video" : { "quality" : "UNKNOW", "width" : 0, "height" : 0, "bitrate" : 0, "frame_rate" : 0 }, "audio" : null, "format" : "UNKNOW" } ], "watermark_template_ids" : null, "description" : null, "common" : { "pvc" : null, "pvc_version" : null, "video_codec" : null, "audio_codec" : "AAC", "hls_interval" : 0 } } ] } ], "total" : 1 } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 template_group_collection_list Array of TemplateGroupCollection objects 模板组集合信息 total Integer 总记录条数 表5 TemplateGroupCollection 参数 参数类型 描述 group_collection_id String 模板组集合id name String 模板组集合名称 description String 模板介绍 template_group_list Array of TemplateGroup objects 转码组列表 表6 TemplateGroup 参数 参数类型 描述 group_id String 模板组id name String 模板组名称 status String 是否默认 type String 模板组类型 auto_encrypt Integer 是否自动加密。 取值如下： 0：表示不加密。 1：表示需要加密。 默认值：0。 加密与转码必须要一起进行，当需要加密时，转码参数不能为空，且转码输出格式必须要为HLS。 quality_info_list Array of QualityInfo objects 画质配置信息列表 watermark_template_ids Array of strings 绑定的水印模板组ID数组 description String 模板介绍 common Common object 高清低码开关，高清低码版本，编码格式多路共同参数 表7 QualityInfo 参数 参数类型 描述 video VideoTemplateInfo object 模板视频信息 audio AudioTemplateInfo object 模板音频信息 format String 格式。 表8 VideoTemplateInfo 参数 参数类型 描述 quality String 画质。 width Integer 视频宽度。 height Integer 视频高度。 bitrate Integer 码率。 frame_rate Integer 帧率（默认为1，1代表自适应，单位是帧每秒）。 表9 AudioTemplateInfo 参数 参数类型 描述 sample_rate Integer 音频采样率（有效值范围） 1：AUDIO_SAMPLE_AUTO 2：AUDIO_SAMPLE_22050 3：AUDIO_SAMPLE_32000 4：AUDIO_SAMPLE_44100 5：AUDIO_SAMPLE_48000 6：AUDIO_SAMPLE_96000 默认值为1。 bitrate Integer 音频码率（单位：Kbps）。 channels Integer 声道数（有效值范围） 1：AUDIO_CHANNELS_1 2：AUDIO_CHANNELS_2 表10 Common 参数 参数类型 描述 pvc String 高清低码开关。 pvc_version String 高清低码版本。 video_codec String 视频编码格式。 audio_codec String 音频编码格式（有效值范围） 1：AUDIO_CODECTYPE_AAC 2：AUDIO_CODECTYPE_HEAAC1 3：AUDIO_CODECTYPE_HEAAC2 4：AUDIO_CODECTYPE_MP3 默认值为1。 hls_interval Integer 分片时长（默认为5秒）。 状态码： 400 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

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

URI GET /v1.0/{project_id}/asset/template-collection/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 group_collection_id 否 String 模板组集合id offset 否 Integer 偏移量。默认为0。指定group_collection_id时该参数无效。 limit 否 Integer 每页记录数。默认为10，范围[1,100]。指定group_collection_id时该参数无效。

请求示例 创建转码模板 POST https://{endpoint}/v2/{project_id}/asset/template/transcodings Content-Type: application/json { "name": "trans_template_test", "is_default": true, "is_auto_encrypt": false, "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 } }

请求参数 表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。 参考取值范围：0或[40,30000]之间的整数。 frame_rate 是 Integer 帧率，单位是帧每秒。 取值范围：[0-75]之间的整数，小于5帧或大于60帧代表自适应。 表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：双声道 (default) AUDIO_CHANNELS_5_1：5.1声道 表7 CommonInfo 参数 是否必选 参数类型 描述 pvc 否 Boolean 高清低码开关 video_codec 否 String 视频编码格式 H264 H265 audio_codec 否 String 音频编码格式 AAC：AAC格式 (default) HEAAC1：HEAAC1格式 HEAAC2：HEAAC2格式 MP3：MP3格式 is_black_cut 否 Boolean 黑边剪裁类型，默认false不开启黑边剪裁 format 是 String 转码格式 MP4 HLS DASH DASH_HLS MP3 ADTS UNKNOW hls_interval 否 Integer 分片时长，范围2-10（默认为5秒） upsample 否 Boolean 上采样开关，开启后可以提升视频的分辨率，增加采样点的数量，默认值:false，表示不开启上采样。 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 转码后音频是否独立存储。 hls_segment_type 否 String HLS分片的封装格式，目前支持TS和FMP4，默认TS格式

请求参数 表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参数 参数 是否必选 参数类型 描述 bucket 是 String OBS桶名称。 operation 是 String 是否进行桶授权。 取值如下： 0：取消授权。 1：授权。

响应示例 状态码： 200 处理成功返回。 { "id" : 334, "name" : "film", "parent_id" : 0, "level" : 1, "projectId" : "58411d8df90649a39b75d75b54e01358" } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

请求参数 表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 媒资分类名称。 id 是 Integer 媒资分类ID。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 name String 媒资分类名称。 parent_id Integer 父分类ID。 一级分类父ID为0。 id Integer 媒资分类ID。 level Integer 媒资分类层级。 取值如下： 1：一级分类层级。 2：二级分类层级。 3：三级分类层级。 projectId String 项目ID。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应示例 状态码： 200 处理成功返回。 { "total" : 0, "task_id" : "973", "task_status" : "SUCCEED", "assets" : [ ] } 状态码： 403 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

URI GET /v1.0/{project_id}/asset/obs/host/stock/task/details 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 task_id 是 String 任务ID。 page 否 Integer 分页编号，默认为0。 size 否 Integer 每页记录数。 默认10，范围[1,100]

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

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total Integer 总数。 task_id String 任务ID。 task_status String 任务状态。 assets Array of AssetDetails objects 媒资信息。 表5 AssetDetails 参数 参数类型 描述 asset_id String VOD分配的媒资ID，仅支持查询，不支持修改。 asset_status String 媒资状态。 "CREATING"：上传中 "FAILED"：上传失败 "CREATED"：上传成功 "PUBLISHED"：已发布 "DELETED"：已删除 transcode_status String 转码状态。 "UN_TRANSCODE"：未转码 "WAITING_TRANSCODE"：等待转码，排队中 "TRANSCODING"：转码中 "TRANSCODE_SUCCEED"：转码成功 "TRANSCODE_FAILED"：转码失败 base_info BaseInfo object 媒资基本信息。 transcode_info TranscodeInfo object 转码生成文件信息。 说明： 仅当转码成功后才能查询到此信息，未转码、正在转码以及转码失败时，无此字段信息。 表6 BaseInfo 参数 参数类型 描述 title String 媒资标题。 长度不超过128个字节，UTF8编码。 video_name String 媒资文件名。 description String 媒资描述。 长度不超过1024个字节。 category_id Long 媒资分类id。 category_name String 媒资分类名称。 create_time String 媒资创建时间。 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间。 last_modified String 媒资最近修改时间。 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间。 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 tags String 媒资标签。 单个标签不超过24个字节，最多不超过16个标签。 多个用逗号分隔，UTF8编码。 meta_data MetaData object 视频的元数据信息。 经过视频解析后产生，包括封装格式、大小、分辨率、码率、帧率。 video_url String 原始视频文件的访问地址。 sign_url String 原视频文件的OBS临时访问地址。仅调用查询指定媒资的详细信息接口时才返回具体值。 cover_info_array Array of CoverInfo objects 封面信息。 subtitle_info Array of SubtitleInfo objects 字幕信息数组 source_path File_addr object 媒资存储参数信息。查询接口，仅媒资为托管时有返回值。 output_path File_addr object 媒资存储参数信息。查询接口，仅媒资为托管时有返回值。 表7 CoverInfo 参数 参数类型 描述 cover_url String 封面文件的下载地址。 表8 SubtitleInfo 参数 参数类型 描述 url String 字幕文件的下载地址 id Integer 字幕文件id type String 字幕文件类型 language String 字幕文件语言种类 表9 File_addr 参数 参数类型 描述 bucket String OBS的bucket名称。 location String 桶所在的区域名， 如“华北-北京四”的区域名为“cn-north-4”，创建的桶所在区域必须和点播服务所在区域保持一致。 object String 文件的存储路径。 表10 TranscodeInfo 参数 参数类型 描述 template_group_name String 转码模板组名称。 output Array of Output objects 转码输出数组。 HLS或DASH格式：此数组的成员个数为n+1，n为转码输出路数。 MP4格式：此数组的成员个数为n，n为转码输出路数。 exec_desc String 执行情况描述。 transcode_status String 转码状态。 取值如下： UN_TRANSCODE：未转码 WAITING_TRANSCODE：待转码 TRANSCODING：转码中 TRANSCODE_SUCCEED：转码成功 TRANSCODE_FAILED：转码失败 表11 Output 参数 参数类型 描述 play_type String 协议类型。 取值如下： hls dash mp4 url String 播放URL。 group_id String 所属转码组Id group_name String 所属转码组名称 encrypted Integer 标记流是否已被加密。 取值如下： 0：表示未加密。 1：表示已被加密。 quality String 清晰度。 取值如下： FLUENT：流畅 SD：标清 HD：高清 FULL_HD：超清 meta_data MetaData object 视频的元数据信息。 经过视频解析后产生，包括封装格式、大小、分辨率、码率、帧率。 表12 MetaData 参数 参数类型 描述 pack_type String 视频封装格式。 取值如下： MP4 TS MOV MXF MPG FLV WMV MP3 WMA APE FLAC AAC AC3 MMF AMR M4A M4R OGG WAV WV MP2 AVI F4V M4V MPEG HLS DASH codec String 视频编码格式。 取值如下： MPEG-2 MPEG-4 H.264 H.265 WMV Vorbis AAC AC-3 AMR APE FLAC MP3 MP2 WMA PCM ADPCM WavPack 说明： 如果codec返回unknown，说明不支持解析用户当前发送的音视频编码格式。 duration Long 视频时长。 若视频的原时长为非整数，则该字段值为原时长的向下取整。 若视频的原时长小于1，则该字段值为1。 duration_ms Long 视频时长，单位毫秒。 video_size Long 视频文件大小。 单位：字节。 width Long 视频宽度（单位：像素）。 编码为H.264的取值范围：[32,3840]之间2的倍数。 编码为H.265的取值范围：[320,3840]之间4的倍数。 hight Long 视频高度（单位：像素）。 编码为H.264的取值范围：[32,2160]之间2的倍数 。 编码为H.265的取值范围：[240,2160]之间4的倍数。 height Long 视频高度（单位：像素） bit_rate Long 视频平均码率。 frame_rate Long 帧率（单位：帧每秒）。 取值如下： F RAM ERATE_AUTO = 1, FRAMERATE_10 = 2, FRAMERATE_15 = 3, FRAMERATE_2397 = 4, // 23.97 fps FRAMERATE_24 = 5, FRAMERATE_25 = 6, FRAMERATE_2997 = 7, // 29.97 fps FRAMERATE_30 = 8, FRAMERATE_50 = 9, FRAMERATE_60 = 10 默认值：1。 单位：帧每秒。 quality String 清晰度。 取值如下： FULL_HD：超高清 HD：高清 SD：标清 FLUENT：流畅 AD：自适应 2K 4K audio_channels Integer 音频的声道数。 状态码： 403 表13 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

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

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 name String 媒资分类名称。 parent_id Integer 父分类ID。 一级分类父ID为0。 id Integer 媒资分类ID。 level Integer 媒资分类层级。 取值如下： 1：一级分类层级。 2：二级分类层级。 3：三级分类层级。 projectId String 项目ID。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求参数 表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 媒资分类名称，最大64字节。 parent_id 否 Integer 父分类ID。 若不填，则默认生成一级分类。 根节点分类ID为0。

响应示例 状态码： 200 处理成功返回。 { "id" : 334, "name" : "电影", "parent_id" : 0, "level" : 1, "projectId" : "58411d8df9064*****75d75b54e01358" } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }