5.3 确认媒资上传 5.4 桶授权
5.5 创建媒资：OBS转存方式 5.6 创建媒资：OBS托管方式 5.7 创建媒资：URL拉取注入 5.8 上传检验
5.1 创建媒资：上传方式
功能介绍
调用该接口创建媒资时，需要将对应的媒资文件上传到点播服务的OBS桶中。
若上传的单媒资文件大小小于20M，则可以直接用PUT方法对该接口返回的地址进行 上传。具体使用方法请参考示例1：媒资上传（20M以下）。
若上传的单个媒资大小大于20M，则需要进行二进制流分割后上传，该接口的具体使 用方法请参考示例2：媒资分段上传（20M以上）。
调试
您可以在API Explorer中调试该接口。
URI
POST /v1.0/{project_id}/asset
表5-1 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目ID，获取方法请参考获取项 目ID
请求参数
表5-2 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 否 String 用户Token，使用Token鉴权方 式时必选。
通过调用IAM服务获取用户 Token接口获取（响应消息头中 X-Subject-Token的值）。
Authorization 否 String 使用AK/SK方式认证时必选，携 带的鉴权信息。
X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请 求的发生时间。
表5-3 请求 Body 参数
参数 是否必选 参数类型 描述
title 是 String 媒资标题，长度不超过128个字
节，UTF-8编码。
description 否 String 视频描述，长度不超过1024个 字节。
video_name 是 String 音视频文件名，长度不超过128 个字节。
文件名后缀可选。
参数 是否必选 参数类型 描述
video_type 是 String 上传音视频文件的格式。
取值如下：
● 音频文件：MP3、OGG、
WAV、WMA、APE、
category_id 否 String 媒资分类ID。
您可以调用创建媒资分类接口或
video_md5 否 String 视频文件MD5值。
建议参考媒资上传和更新生成对 应的MD5值。
cover_type 否 String 封面图片文件类型。
取值如下：
● JPG
● PNG
上传后的封面名称是固定的，后 缀名为封面类型缩写。例如 cover0.jpg，cover1.png 若不指 定类型，则封面文件无后缀名。
说明
如果设置了图片格式，则不会执行 首帧截图作为封面动作，需自行上 传封面。
cover_md5 否 String 封面文件MD5值 subtitles 否 Array of
Subtitle objects
字幕文件信息
参数 是否必选 参数类型 描述
tags 否 String 视频标签。
单个标签不超过16个字节，最 多不超过16个标签。
多个用逗号分隔，UTF8编码。
auto_publish 否 Integer 是否自动发布。
取值如下：
● 0：表示不自动发布。
● 1：表示自动发布。
默认值：0。
template_gro
up_name 否 String 转码模板组名称。
若不为空，则使用指定的转码模
auto_encrypt 否 Integer 是否自动加密。
取值如下：
auto_preheat 否 String 是否自动预热到CDN。
取值如下：
● 0：表示不自动预热。
● 1：表示自动预热。
默认值：0。
thumbnail 否 Thumbnail
object 截图参数 review 否 Review object 媒资审核参数
参数 是否必选 参数类型 描述 workflow_na
me 否 String 工作流名称。
若不为空，则使用指定的工作流 对上传的音视频进行处理，您可 以在视频点播控制台配置工作 流，具体请参见工作流设置。
表5-4 Subtitle
参数 是否必选 参数类型 描述
id 是 Integer 字幕id。
取值范围：[1,8]。
type 是 String 字幕文件类型，目前暂只支持
“SRT”。
language 是 String 字幕语音类型。
取值如下：
● CN：表示中文字幕。
● EN：表示英文字幕。
md5 否 String 字幕文件的MD5值。
description 否 String 字幕描述。
表5-5 Thumbnail
参数 是否必选 参数类型 描述
type 是 String 截图类型。
取值如下：
● time：每次进行截图的间隔 时间。
● dots: 按照指定的时间点截 图。
time 否 Integer type取值为time时必填。根据 时间间隔采样时的时间间隔值。
取值范围：[1,12]之间的整数。
单位：秒。
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 截图最长边的尺寸。
单位：像素。
宽边尺寸按照该尺寸与原始视频 像素等比缩放计算。
表5-6 Review
参数 是否必选 参数类型 描述
template_id 是 String 审核模板ID。您可以在视频点播 控制台配置审核模板后获取，具 体请参见审核设置。
响应参数
状态码： 200
表5-7 响应 Body 参数
参数 参数类型 描述
asset_id String 媒体ID video_upload_
url String 视频上传URL
cover_upload_
url String 封面上传地址
参数 参数类型 描述 subtitle_uploa
d_urls Array of
strings 字幕文件上传url数组 target File_addr
object 媒资存储参数信息。
表5-8 File_addr
参数 参数类型 描述
bucket String OBS的bucket名称。
location String 桶所在的区域名， 如“华北-北京四”的区域名 为“cn-north-4”，创建的桶所在区域必须和点 播服务所在区域保持一致。
object String 文件的存储路径。
状态码： 403
表5-9 响应 Body 参数
参数 参数类型 描述
error_code String 错误码。
error_msg String 错误描述。
请求示例
POST https://{endpoint}/v1/{project_id}/asset { "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"
} ] }
响应示例
状态码： 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=CBN2JOVSQVVUREU0RCSN&Expires=1518147618&Signature=kZYh0hEos2VJhjjdHC2zVAH GyXA%3D",
"cover_upload_url" : "https://obs.cn-north-4.myhuaweicloud.com:443/obs-vod-1/%7Bproject_id%7D/
f488337c31c8e4622f1590735b134c65/cover/Cover0.jpg?
AWSAccessKeyId=CBN2JOVSQVVUREU0RCSN&Expires=1518147619&Signature=eVoLA54Qi6cG9vZbS3fuaIw1 RDQ%3D",
"subtitle_upload_urls" : [ "https://obs-vod-1.obs.cn-north-4.myhuaweicloud.com:
443/14ce1d4437164aba8b364ce15866154e/53a018d2dc53ca07eb5a07a839205c9d/subtitle/1.srt?
AWSAccessKeyId=CBN2JOVSQVVUREU0RCSN&Expires=1534760131&Signature=twZPabMSf%2FO
%2B2H3mpo3Gsqk1uIo%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."
}