视频点播 VOD-华为云

视频点播 VOD-确认水印图片上传:响应示例

响应示例状态码： 200 处理成功返回。 { "id" : "2305739f855413a84af9e6ad6e2b21be", "image_url" : "https://vod-bucket-26-cn-north-4.obs.cn-north-4.myhuaweicloud.com:443/05ab5cef408026f22f62c018de60cf2e/a52ba84366abebb4c4614e1b16973549/watermark.png?AWSAccessKeyId=CBN2J**********0R CS N&Expires=1625479312&Signature=kZYh0hEos2V**********AHGyXA%3D" } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

视频点播 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参数参数是否必选参数类型描述 id 是 String 水印配置模板id。 status 是 String 水印上传状态，传值支持"SUCCEED"和"FAILED"。

视频点播 VOD

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

请求示例修改转码模板集合 POST https://{endpoint}/v1.0/{project_id}/asset/template-collection/transcodings Content-Type: application/json { "collection_id": "f9b045e0811c482f9de0d436a5927bb6", "name": "test", "template_group_list": [ "780640dd1d584a6999b104568c358b78", "6a16d8d0161c42caa42b9c148d032871" ] }

视频点播 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 模板组集合名称 collection_id 是 String 模板组集合ID description 否 String 模板组集合介绍 template_group_list 否 Array of strings 模板组列表

视频点播 VOD

视频点播 VOD-（即将下线）查询托管任务:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 tasks Array of TakeOverTask objects 托管任务信息。 total Integer 任务数量。表5 TakeOverTask 参数参数类型描述 bucket String 桶名。 object String 目录/文件名。 host_type Integer 托管类型。取值如下： 0：表示存储到点播桶 1：表示存储在租户桶 2：表示存储到租户OBS桶中，且输出目录与源文件的存储目录相同。 output_bucket String 输出桶。 output_path String 输出路径。 task_id String 任务ID。 suffix Array of strings 托管文件类型。 template_group_name String 转码模板组。 create_time String 创建时间。 end_time String 结束时间。 status String 任务状态。 exec_desc String 媒资的任务执行描述汇总。状态码： 403 表6 响应Body参数参数参数类型描述 error_code String 错误码。 error_msg String 错误描述。

视频点播 VOD

视频点播 VOD-（即将下线）查询托管任务:响应示例

响应示例状态码： 200 处理成功返回。 { "tasks" : [ { "bucket" : "obs-test", "object" : "play_violin.mp4", "host_type" : 0, "output_bucket" : "", "output_path" : null, "task_id" : "973", "suffix" : [ ], "template_group_name" : null, "create_time" : "20210629074248", "end_time" : "20210629074250", "status" : "SUCCEED", "exec_desc" : null } ], "total" : 1 } 状态码： 403 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

视频点播 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 /v1.0/{project_id}/asset/obs/host/stock/task 表1 路径参数参数是否必选参数类型描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数参数是否必选参数类型描述 status 否 String 任务状态。 task_id 否 String 任务ID。 page 否 Integer 分页编号，默认为0。 size 否 Integer 每页记录数。默认10，范围[1,100]，指定task_id时该参数无效。

视频点播 VOD

视频点播 VOD-媒资发布取消:响应示例

响应示例状态码： 200 处理成功返回。 { "asset_info_array" : [ { "asset_id" : "f488337c31c8e4622f1590735b134c65", "status" : "UNCREATED", "description" : "Asset meta download fail, errorCode is VOD.100021010,\nerrorMsg is Internal server communication is abnormal", "base_info" : { "title" : "Avatar test test", "video_name" : "Avatar_480P.mp4", "description" : "Avatar, test", "category_id" : -1, "category_name" : "其他", "create_time" : "20180209024019", "last_modified" : "20180209024019", "video_type" : "MP4", "tags" : "mytags" } }, { "asset_id" : "07ba4d46463355e800c2f42f628f0631", "status" : "NOASSET", "description" : "no asset" } ] } 状态码： 403 处理失败返回。 { "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/status/unpublish Content-Type: application/json { "asset_id": [ "f488337c31c8e4622f1590735b134c65", "07ba4d46463355e800c2f42f628f0631" ] }

视频点播 VOD

视频点播 VOD-媒资发布取消:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 asset_info_array Array of AssetInfo objects 媒资状态集合。表5 AssetInfo 参数参数类型描述 asset_id String VOD分配的媒资ID，仅支持查询，不支持修改。 is_multi_transcode Boolean 是否是多转码模式 status String 媒资状态。取值如下： UNCREATED：未创建（媒资ID不存在） DELETED：已删除 CANCELLED：上传取消 SERVER_ERROR：上传失败（点播服务端故障） UPLOAD_FAILED：上传失败（向OBS上传失败） CREATING：创建中 PUBLISHED：已发布 WAITING_TRANSCODE：待发布（转码排队中） TRANSCODING：待发布（转码中） TRANSCODE_FAILED：待发布（转码失败） TRANSCODE_SUCCEED：待发布（转码成功） CREATED：待发布（未转码） NO_ASSET：该媒资不存在 DELETING：正在删除 DELETE_FAILED：删除失败 OBS_CREATING：OBS转存方式创建中 OBS_CREATE_FAILED： OBS转存失败 OBS_CREATE_SUC CES S： OBS转存成功 description String 媒资子状态或描述信息。对于媒资异常场景，描述具体的异常原因。对于正常场景，描述媒资的处理信息。 base_info BaseInfo object 媒资基本信息。 play_info_array Array of PlayInfo objects 转码文件的播放信息。 HLS或DASH：此数组的成员个数为n+1，n为转码输出路数。 MP4：此数组的成员个数为n，n为转码输出路数。表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 PlayInfo 参数参数类型描述 play_type String 播放协议类型。取值如下： hls dash mp4 group_id String 所属转码组Id group_name String 所属转码组名称 url String 播放URL。 encrypted Integer 标记流是否已被加密。取值如下： 0：表示未加密。 1：表示已被加密。默认值：0。 meta_data MetaData object 视频的元数据信息。经过视频解析后产生，包括封装格式、大小、分辨率、码率、帧率。表11 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 视频时长。若视频的原时长为非整数，则该字段值为原时长的向上取整。 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 表12 响应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 是 Array of strings VOD分配的媒资ID，仅支持查询，不支持修改。

视频点播 VOD

视频点播 VOD-创建水印模板:响应示例

响应示例状态码： 200 处理成功返回 { "id" : "a52ba84366abebb4c4614e1b16973549", "upload_url" : "https://vod-bucket-26-cn-north-4.obs.cn-north-4.myhuaweicloud.com:443/05ab5cef408026f22f62c018de60cf2e/a52ba84366abebb4c4614e1b16973549/watermark.png?AWSAccessKeyId=CBN2J**********0RCSN&Expires=1625479312&Signature=kZYh0hEos2V**********AHGyXA%3D" } 状态码： 400 处理失败返回 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

视频点播 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 水印模板名称。 watermark_type 否 String 水印类型，当前只支持IMAGE（图片水印）。 image_process 否 String watermark_type设置为IMAGE时有效。目前包括： ORIGINAL：只做简单缩放，不做其他处理 TRANSPARENT：图片底色透明 GRAYED：彩色图片变灰 dx 否 String 水印图片相对输出视频的水平偏移量，默认值是0。设置方法有两种，建议小数型，整数型可能导致控制台图片无法预览，但不影响转码：整数型：表示图片起点水平偏移视频顶点的像素值，单位px。取值范围：[0，4096] 小数型：表示图片起点相对于视频分辨率宽的水平偏移比率。取值范围：(0，1)，支持4位小数，如0.9999，超出部分系统自动丢弃。 dy 否 String 水印图片相对输出视频的垂直偏移量，默认值是0。设置方法有两种，建议小数型，整数型可能导致控制台图片无法预览，但不影响转码：整数型：表示图片起点垂直偏移视频顶点的像素值，单位px。取值范围：[0，4096] 小数型：表示图片起点相对于视频分辨率高的垂直偏移比率。取值范围：(0，1)，支持4位小数，如0.9999，超出部分系统自动丢弃。 position 否 String 水印的位置，默认TOPRIGHT。目前包括： TOPRIGHT：右上位置 TOPLEFT：左上位置 BOTTOMRIGHT：右下位置 BOTTOMLEFT：左下位置 width 否 String 水印图片宽，建议小数型，整数型可能导致控制台图片无法预览，但不影响转码。值有两种形式：整数型代水印图片宽的像素值，范围[8，4096]，单位px。小数型代表相对输出视频分辨率宽的比率，范围(0,1)，支持4位小数，如0.9999，超出部分系统自动丢弃。 height 否 String 水印图片高，建议小数型，整数型可能导致控制台图片无法预览，但不影响转码。值有两种形式：整数型代表水印图片高的像素值，范围[8，4096]，单位px。小数型代表相对输出视频分辨率高的比率，范围(0，1)，支持4位小数，如0.9999，超出部分系统自动丢弃。 timeline_start 否 String 水印开始时间，与"timeline_duration"配合使用。取值范围:[0, END)。"END"表示视频结束时间。单位:秒。 timeline_duration 否 String 水印持续时间，与"timeline_start"配合使用。取值范围:(0,END-开始时间]。"END"表示视频结束时间。单位:秒。默认:END。 type 是 String 仅支持png、jpg和jpeg格式的图片作为水印模板，传值仅支持JPG、JPEG和PNG三种字符串。 md5 否 String 水印图片MD5值。

视频点播 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

7*24

备案

专业服务

退订

建议反馈

售前咨询热线