华为云用户手册

响应示例 状态码：200 处理成功返回。 { "top_urls" : [ { "value" : 0, "asset_id" : "548b6023bf2cc925bd64343f04ca0f88", "title" : "test", "duration" : 0, "duration_ms" : 0, "size" : 0 } ]} 状态码：400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}."}

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 top_urls Array of TopUrl objects 指定 域名 top100 URL集合 表5 TopUrl 参数 参数类型 描述 value Long 总播放次数。 asset_id String VOD分配的媒资ID，仅支持查询，不支持修改。 title String 媒资名称。 duration Integer 媒资时长。 单位：秒。 duration_ms Long 视频时长，单位毫秒。 size Long 媒资原始大小。 单位：字节。 状态码：400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

URI GET /v1.0/{project_id}/asset/top-statistics 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 domain 是 String 查询域名，暂只支持查询单个或者全部域名。 取值如下： 单个加速域名，格式：example.test1.com。 ALL：表示查询名下全部域名。 date 是 String 查询日期，格式为yyyymmdd date必须为昨天或之前的日期。 最多只能查最近一个月内的数据。

响应参数 状态码：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 错误描述。

响应示例 状态码：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."}

请求参数 表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 鉴政内容检测置信度，取值范围为-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。

请求示例 创建媒资 POST https://{endpoint}/v1/{project_id}/assetContent-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" } ]}

请求参数 表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，仅支持查询，不支持修改。 status 是 String 上传状态。 取值如下： CREATED：创建成功。 FAILED：创建失败。 CANCELLED：创建取消。

响应示例 状态码：200 处理成功返回。 { "asset_id" : "41cff636d5b12a51e7eb2838bbf45201", "base_info" : { "title" : "Avatar", "video_name" : "视频点播 VOD 视频.mp4", "description" : "Avatar, marketed as James Cameron's Avatar, is a 2009 American\nepic science fiction film directed, written, produced, and\nco-edited by James Cameron", "category_id" : -1, "category_name" : "其他", "create_time" : "20190612032250", "last_modified" : "20190613075030", "video_type" : "MP4", "tags" : "test1,test2", "meta_data" : { "pack_type" : null, "codec" : "H.264", "duration" : 131, "duration_ms" : 131000, "video_size" : 4942645, "width" : 1280, "hight" : 720, "height" : 720, "bit_rate" : 173, "frame_rate" : 30 }, "video_url" : "https://355.cdn-vod.huaweicloud.com/asset/41cff636d5b12a51e7eb2838bbf45201/5597e59de70722eaeb9b18c274e249b2.mp4", "sign_url" : "https://vod-bucket-57-cn-north-4.obs.cn-north-4.myhuaweicloud.com:443/05ab5cef408026f22f62c018de60cf2e/41cff636d5b12a51e7eb2838bbf45201 /5597e59de70722eaeb9b18c274e249b2.mp4?AWSAccessKeyId=CBN2J**********0RCSN&Expires=1652499973&Signature=kZYh0hEos2V**********AHGyXA%3D", "cover_info_array" : [ { "cover_url" : "https://355.cdn-vod.huaweicloud.com/asset/41cff636d5b12a51e7eb2838bbf45201/cover/Cover0.jpg" } ] }, "transcode_info" : { "template_group_name" : "system_template_group", "output" : [ { "play_type" : "HLS", "url" : "https://355.cdn-vod.huaweicloud.com/asset/41cff636d5b12a51e7eb2838bbf45201/play_video/index.m3u8", "encrypted" : 0, "meta_data" : { "pack_type" : null, "codec" : "H.264", "duration" : 0, "duration_ms" : 0, "video_size" : 0, "width" : 0, "hight" : 0, "height" : 0, "bit_rate" : 0, "frame_rate" : 0 } }, { "play_type" : "HLS", "url" : "https://355.cdn-vod.huaweicloud.com/asset/41cff636d5b12a51e7eb2838bbf45201/play_video/视频点播VOD 视频_1_854X480_600_0.m3u8", "encrypted" : 0, "quality" : "SD", "meta_data" : { "pack_type" : null, "codec" : "H.264", "duration" : 130, "duration_ms" : 130000, "video_size" : 7976960, "width" : 854, "hight" : 480, "height" : 480, "bit_rate" : 421, "frame_rate" : 30000, "quality" : "SD" } }, { "play_type" : "DASH", "url" : "https://355.cdn-vod.huaweicloud.com/asset/41cff636d5b12a51e7eb2838bbf45201/play_video/index.mpd", "encrypted" : 0, "meta_data" : { "pack_type" : null, "codec" : "H.264", "duration" : 0, "duration_ms" : 0, "video_size" : 0, "width" : 0, "hight" : 0, "height" : 0, "bit_rate" : 0, "frame_rate" : 0 } }, { "play_type" : "DASH", "encrypted" : 0, "quality" : "SD", "meta_data" : { "pack_type" : null, "codec" : "H.264", "duration" : 130, "duration_ms" : 130000, "video_size" : 7976960, "width" : 854, "hight" : 480, "height" : 480, "bit_rate" : 421, "frame_rate" : 30000, "quality" : "SD" } } ], "exec_desc" : "Transcode success", "transcode_status" : "TRANSCODE_SUCCEED" }} 状态码：400 处理失败返回。 { "error_code" : "VOD.10062", "error_msg" : "Media asset or resource does not exist, please check."}

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 asset_id String VOD分配的媒资ID，仅支持查询，不支持修改。 base_info BaseInfo object 媒资基本信息。 transcode_info TranscodeInfo object 转码生成文件信息。 说明： 仅当转码成功后才能查询到此信息，未转码、正在转码以及转码失败时，无此字段信息。 thumbnail_info ThumbnailInfo object 截图信息。 说明： 仅当截图成功后才能查询到此信息，未截图、正在截图以及截图失败时，无此字段信息。 review_info ReviewInfo object 审核信息数组。 说明： 仅当审核成功后才能查询到此信息，未审核、正在审核以及审核失败时，无此字段信息。 表5 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 媒资存储参数信息。查询接口，仅媒资为托管时有返回值。 表6 CoverInfo 参数 参数类型 描述 cover_url String 封面文件的下载地址。 表7 SubtitleInfo 参数 参数类型 描述 url String 字幕文件的下载地址 id Integer 字幕文件id type String 字幕文件类型 language String 字幕文件语言种类 表8 File_addr 参数 参数类型 描述 bucket String OBS的bucket名称。 location String 桶所在的区域名， 如“华北-北京四”的区域名为“cn-north-4”，创建的桶所在区域必须和点播服务所在区域保持一致。 object String 文件的存储路径。 表9 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：转码失败 表10 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 视频的元数据信息。 经过视频解析后产生，包括封装格式、大小、分辨率、码率、帧率。 表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 视频时长，单位：秒。 若视频的原时长为非整数，则该字段值为原时长的向下取整。 若视频的原时长小于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 音频的声道数。 表12 ThumbnailInfo 参数 参数类型 描述 sample Array of ThumbnailRsp objects 视频截图信息，截图类型为间隔。 dots Array of ThumbnailRsp objects 视频截图信息，截图类型为时间点。 quantity Array of ThumbnailRsp objects 视频截图信息，截图类型为数量。 exec_desc String 执行情况描述。 thumbnail_status String 截图状态。 取值如下： UN_THUMBNAIL：未截图 THUMBNAILING：截图中 THUMBNAIL_SUCCEED：截图成功 THUMBNAIL_FAILED：截图失败 表13 ThumbnailRsp 参数 参数类型 描述 offset Integer 截图在视频中的时间偏移，单位为秒。 url String 截图访问URL 表14 ReviewInfo 参数 参数类型 描述 suggestion String 检测结果是否通过。 取值如下： block：包含敏感信息，不通过。 pass：不包含敏感信息，通过。 review：需要人工复检。 说明： 当同时检测多个场景时，suggestion的值以最可能包含敏感信息的场景为准。即任一场景出现了block则总的suggestion为block，所有场景都pass时suggestion为pass，这两种情况之外则一定有场景需要review，此时suggestion为review。 text TextReviewRet object 文本检测结果 cover Array of PictureReviewRet objects 封面检测结果。 video Array of PictureReviewRet objects 视频检测结果。 exec_desc String 执行情况描述。 review_status String 审核状态。 取值如下： UN_REVIEW：未审核 REVIEWING：审核中 REVIEW_SUSPICIOUS：审核可疑，需要人工审核 REVIEW_PASSED：审核通过 REVIEW_FAILED：审核失败。 REVIEW_BLOCKED：已屏蔽。 表15 TextReviewRet 参数 参数类型 描述 suggestion String 检测结果是否通过。 取值如下： block：包含敏感信息，不通过。 pass：不包含敏感信息，通过。 review：需要人工复检。 politics String 涉政敏感词列表 porn String 涉黄敏感词列表 abuse String 辱骂敏感词列表 表16 PictureReviewRet 参数 参数类型 描述 suggestion String 检测结果是否通过。 取值如下： block：包含敏感信息，不通过。 pass：不包含敏感信息，通过。 review：需要人工复检。 offset Integer 截图在视频中的时间偏移值。封面不涉及此字段 单位：秒。 url String 对应截图/封面的访问URL。 politics Array of ReviewDetail objects 政治因素审核结果。 terrorism Array of ReviewDetail objects 暴恐元素审核结果。 porn Array of ReviewDetail objects 涉黄 内容审核 结果。 表17 ReviewDetail 参数 参数类型 描述 confidence String 置信度。 取值范围：[0,1]。 label String 每个检测结果的标签化说明。 politics场景：label为对应的政治人物信息。 terrorism场景： label为对应的暴恐元素（枪支、刀具、火灾等） 信息。 porn场景：label为对应的涉黄元素（涉黄、性感等）信息。 状态码：400 表18 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

URI GET /v1.0/{project_id}/asset/details 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 asset_id 是 String VOD分配的媒资ID，仅支持查询，不支持修改。 categories 否 Array of strings 查询的信息类型。 为空时表示查询所有信息。 不为空时支持同时查询一个或者多个类型的信息，取值如下： base_info：媒资基本信息。 transcode_info：转码结果信息。 thumbnail_info：截图结果信息。 review_info：审核结果信息。

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

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

调用API获取项目ID 您还能通过调用查询指定条件下的项目信息API获取项目ID。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects/”，其中{Endpoint}为IAM的终端节点可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下，其中projects下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "region01", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

请求参数 表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。

上传校验 调用上传检验接口时，点播服务会根据媒资的MD5值来检查是否已有重复的媒资文件。MD5值的生成方式是取媒资文件的1024字节，并进行MD5计算，示例代码如下所示： 1 2 3 4 5 6 7 8 9101112131415161718192021222324252627 import java.io.File;import java.io.IOException;import java.nio.ByteBuffer;import java.nio.channels.SeekableByteChannel;import java.nio.file.Files;import java.nio.file.Path;import java.nio.file.Paths;import java.nio.file.StandardOpenOption;import org.apache.commons.codec.digest.DigestUtils;public class VodDemoDuplicateCheckMd5 { public static String computeMd5ByFile(String fileUrl) { String md5Content = null; Path targetFile = Paths.get(fileUrl); try (SeekableByteChannel channel = Files.newByteChannel(targetFile, StandardOpenOption.READ)) { ByteBuffer byteBuffer = ByteBuffer.allocate(1025); channel.read(byteBuffer); byteBuffer.flip(); byte[] data = new byte[byteBuffer.limit()]; byteBuffer.get(data); md5Content = DigestUtils.md5Hex(data); } catch (IOException e) { throw new RuntimeException(String.format("Read file %s failed.", fileUrl)); } return md5Content; }}

请求参数 表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 模板组名称。 status 否 String 是否设置默认。 type 是 String 模板组类型。 auto_encrypt 否 Integer 是否自动加密。 取值如下： 0：表示不加密。 1：表示需要加密。 默认值：0。 加密与转码必须要一起进行，当需要加密时，转码参数不能为空，且转码输出格式必须要为HLS。 quality_info_list 否 Array of QualityInfo objects 画质配置信息列表。 common 否 Common object 模板信息。 watermark_template_ids 否 Array of strings 绑定的水印模板组ID数组。 description 否 String 模板介绍。 表4 QualityInfo 参数 是否必选 参数类型 描述 video 否 VideoTemplateInfo object 模板视频信息 audio 否 AudioTemplateInfo object 模板音频信息 format 是 String 格式。 表5 VideoTemplateInfo 参数 是否必选 参数类型 描述 quality 是 String 画质。 width 否 Integer 视频宽度。 height 否 Integer 视频高度。 bitrate 否 Integer 码率。 frame_rate 否 Integer 帧率（默认为1，1代表自适应，单位是帧每秒）。 表6 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 表7 Common 参数 是否必选 参数类型 描述 pvc 是 String pvc开关。 pvc_version 否 String pvc版本。 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秒）。

请求示例 POST https://{endpoint}/v1.0/{project_id}/asset/template_group/transcodings{ "name" : "template_group_test", "type" : "custom_template_group", "auto_encrypt" : 0, "quality_info_list" : [ { "video" : { "width" : 1280, "height" : 720, "bitrate" : 1000, "quality" : "HD", "frame_rate" : 1 }, "audio" : { "sample_rate" : 1, "channels" : 2, "bitrate" : 0 }, "format" : "HLS" } ], "status" : "0", "watermark_template_ids" : [ ], "common" : { "pvc" : "0", "video_codec" : "H264", "audio_codec" : "AAC", "hls_interval" : 5 }}

前提条件 已明确需要上传媒资的点播服务所在的区域信息，详见使用前必读。 已获取需要上传到对应点播服务所在区域的项目ID，具体获取方法请参见获取项目ID。 待上传的视频文件已完成二进制流分割，建议每个分段的大小不超过20M。 OBS接口列举已上传的段支持响应段的取值范围[1,10000]，段大小[100KB,5GB]。默认最多响应1000段，如果用户分段数目超出1000，需参考OBS接口列举已上传的段进行处理。

请求参数 表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 name 是 String 水印模板名称 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，超出部分系统自动丢弃。 watermark_type 否 String 水印类型，当前只支持IMAGE（图片水印） image_process 否 String watermark_type设置为IMAGE时有效。 目前包括： ORIGINAL：只做简单缩放，不做其他处理 TRANSPARENT：图片底色透明 GRAYED：彩色图片变灰 timeline_start 否 String 水印开始时间，与"timeline_duration"配合使用。 取值范围:[0, END)。"END"表示视频结束时间。 单位:秒。 timeline_duration 否 String 水印持续时间，与"timeline_start"配合使用。 取值范围:(0,END-开始时间]。"END"表示视频结束时间。 单位:秒。 默认:END。

请求示例 PUT https://{endpoint}/v1.0/{project_id}/asset/template_group/transcodings{ "group_id" : "f9b045e0811c482f9de0d436a5927bb6", "name" : "template_group_test", "type" : "custom_template_group", "auto_encrypt" : 0, "quality_info_list" : [ { "video" : { "width" : 1280, "height" : 720, "bitrate" : 1000, "quality" : "HD", "frame_rate" : 1 }, "audio" : { "sample_rate" : 1, "channels" : 2, "bitrate" : 0 }, "format" : "HLS" } ], "status" : "0", "watermark_template_ids" : [ ], "common" : { "pvc" : "0", "video_codec" : "H264", "audio_codec" : "AAC", "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参数 参数 是否必选 参数类型 描述 group_id 是 String 模板组ID。 name 是 String 模板组名称。 status 否 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 模板信息。 表4 QualityInfo 参数 是否必选 参数类型 描述 video 否 VideoTemplateInfo object 模板视频信息 audio 否 AudioTemplateInfo object 模板音频信息 format 是 String 格式。 表5 VideoTemplateInfo 参数 是否必选 参数类型 描述 quality 是 String 画质。 width 否 Integer 视频宽度。 height 否 Integer 视频高度。 bitrate 否 Integer 码率。 frame_rate 否 Integer 帧率（默认为1，1代表自适应，单位是帧每秒）。 表6 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 表7 Common 参数 是否必选 参数类型 描述 pvc 是 String pvc开关。 pvc_version 否 String pvc版本。 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秒）。

账户内余额为零，也没购买短信套餐包，为何能成功发送短信？ 华为云账户余额为零，状态正常，可以发送短信。如果未购买短信套餐包或已发送短信的业务类型与已购买的短信套餐包类型不符，发送成功的短信将产生按需计费，从华为云账户余额中划扣。短信计费方式 当华为云账户处于欠费冻结状态时，将无法使用短信服务，也无法使用短信套餐包剩余额度。 为了避免因欠费导致账户冻结，而无法使用短信服务，请在使用短信服务发送短信前，先在华为云账户中充值（如何给账户充值），或预先购买短信套餐包（购买国内短信套餐包）。 父主题： 短信发送相关

调试发送短信功能时，报Could not derive key，如何处理？ 执行代码样例中，AK/SK认证的短信样例时，如果报错“Could not derive key”，建议排查jar包依赖是否冲突。 比如，jar包依赖是这样时： Maven: org.bouncycastle:bcpkix-jdk15on:1.68Maven: org.bouncycastle:bcprov-jdk15on:1.68Maven:org.bouncycastle:bcprov-jdk15to18:1.70 需要将下面这些版本调整成一致的版本，可以都修改为1.68，如下： Maven: org.bouncycastle:bcpkix-jdk15on:1.68Maven: org.bouncycastle:bcprov-jdk15on:1.68Maven:org.bouncycastle:bcprov-jdk15to18:1.68 父主题： 故障排除

调用接口发送短信时，填写的手机号码有格式要求吗？ 调用发送短信API和发送分批短信API时，请求参数“to”用于填写短信接收方的号码，标准号码格式为：+{国家码}{地区码}{终端号码}。 发送国内短信，如果“+{国家码}”不存在，则默认为+86，如果接收方号码为手机号码，则{地区码}可选。如：+86131****5678。 如果携带多个接收方号码，则以英文逗号分隔。每个号码最大长度为21位，最多允许携带500个号码。 父主题： 其他问题

资质已审核通过，关联上签名后，为何签名的状态为“处理完毕（资质审核中）”？ 历史已审核通过的签名，单击“补充资质”，关联上对应的资质后，会提交审核。若签名和资质相符，则签名状态会变更为“处理完毕（实名报备中）”并向运营商报备，报备完成后签名状态变更为“处理完毕”；若签名和资质不符，则签名状态会变更为“处理完毕（实名报备失败）”，您需要根据报备失败的原因进行修改后，重新提交资质报备。 父主题： 资质相关

添加签名时，签名归属企业与实名认证企业不一致，如何处理？ 变更认证信息。请确认华为云账号的实名认证信息是否需要变更，请参见企业账号如何完成重新实名认证进行变更。 提供第三方公司的营业执照或副本复印件（要加盖企业公章）。请确认是否涉及第三方权益，如涉及A公司替B公司申请签名，即签名归属主体属于B，则签名申请材料中的营业执照，需上传B公司的营业执照正本或副本复印件（要加盖企业公章），且还需上传B公司给予A公司的授权委托书。 父主题： 签名相关

开通短信服务异常，如何处理？ 异常现象 处理建议 提示“您尚未绑定邮箱，去绑定”。 请进入账号中心，查看是否已绑定注册邮箱。如果未绑定，请绑定后重试；如果已绑定，请修改绑定后重试。 提示“检测到华为云账号变更，请联系客服进行资源的关联”。 请确认是否修改过华为云账号的账号名，修改回原账号名后重试，或提供修改前后的账号名，联系华为云客服处理。 提示“没有余额无法正常开通”。 请参考如何给账户充值，充值后再开通短信服务。 提示“暂不支持IAM用户开通服务，请使用主账号登录后开通服务”。 消息&短信暂只支持主账号开通服务，请使用主账号登录开通，授予子账号对应区域的消息&短信服务权限。 查询服务是否开通报错。 请检查账号实名认证信息，确认已通过华为云企业实名认证。请确认用户基本信息已完善，手机号已绑定。 国内短信请单击页面左上角“控制台”，切换区域至华北-北京四。 请确认已勾选“我已阅读并同意《消息&短信服务使用声明》”。 请清理浏览器缓存后重试。 单击“立即开通”无反应或页面未跳转。 无法单击“立即开通”（按钮呈灰色，不可单击）。 父主题： 故障排除

为什么个别号码收不到短信？ 个别号码收不到短信，请通过短信控制台查看短信发送状态。 如果状态显示错误码，请参考状态回执错误码处理。例如当状态码显示MBBLACK时，说明手机号码位于黑名单中，可能是该号码回复过退订信息或者该号码用户向工信部投诉过，如果该号码需要接收短信，可以联系华为云客服处理。 如果短信发送状态显示成功，手机未收到短信，建议检查接收方手机号码是否欠费停机、手机是否关机，无信号，或者手机本地是否有拦截。如果手机状态正常，仍收不到短信，建议提交工单联系华为云技术客服处理。 父主题： 故障排除

短信API测试过程中，因达到发送频率限制，测试手机号不能接收短信，该怎么办？ 可以等待一个频次限制周期，待发送频率自动解除后重试，短信发送频率限制如下表所示： 限制项 短信类型 限制频率 说明 号码频次 验证码 2次/分钟 任意1分钟内，对同一个手机号码发送短信最多2次，超出次数会被限制。 50次/24小时 任意24小时内，对同一个手机号码发送短信最多50次，超出次数会被限制。 通知 10次/分钟 任意1分钟内，对同一个手机号码发送短信最多10次，超出次数会被限制。 50次/24小时 任意24小时内，对同一个手机号码发送短信最多50次，超出次数会被限制。 推广 4次/1小时 任意1小时内，对同一个手机号码发送短信最多4次，超出次数会被限制。 推广短信发送时间为每日8:00 - 22:00，夜间无法发送。 10次/24小时 任意24小时内，对同一个手机号码发送短信最多10次，超出次数会被限制。 推广短信发送时间为每日8:00 - 22:00，夜间无法发送。 同号同内容管控 验证码/通知/推广 2次/59秒 任意59秒内，对同一个手机号码发送同一短信（内容完全相同）最多2次，超出次数会被限制。 5次/59分钟 任意59分钟内，对同一个手机号码发送同一短信（内容完全相同）最多5次，超出次数会被限制。 父主题： 故障排除