媒资处理
功能介绍
实现视频转码、截图、加密等处理。既可以同时启动多种操作，也可以只启动一种操作。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v1.0/{project_id}/asset/process
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
项目ID，获取方法请参考获取项目ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
否 |
String |
用户Token，使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
Authorization |
否 |
String |
使用AK/SK方式认证时必选，携带的鉴权信息。 |
X-Sdk-Date |
否 |
String |
使用AK/SK方式认证时必选，请求的发生时间。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
asset_id |
是 |
String |
VOD分配的媒资ID，仅支持查询，不支持修改。 |
template_group_name |
否 |
String |
转码模板组名称。
说明：
若不为空，则使用指定的转码模板对上传的音视频进行转码，您可以在视频点播控制台配置转码模板，具体请参见《点播服务用户指南》中的“转码设置”。 |
auto_encrypt |
否 |
Integer |
是否自动加密。 取值如下：
默认值：0。 加密与转码必须要一起进行，当需要加密时，转码参数不能为空，且转码输出格式必须要为HLS。 |
thumbnail |
否 |
Thumbnail object |
截图参数 |
subtitle_id |
否 |
Array of integers |
字幕文件ID。
说明：
仅在创建媒资时，请求参数设置了“subtitles”时，该参数设置才生效。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
type |
是 |
String |
截图类型。 取值如下：
|
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 。 |
aspect_ratio |
否 |
Integer |
纵横比，图像缩放方式。 取值如下：
默认值：0。 |
max_length |
否 |
Integer |
截图最长边的尺寸。 单位：像素。 宽边尺寸按照该尺寸与原始视频像素等比缩放计算。 默认值：480。 |
响应参数
状态码： 202
参数 |
参数类型 |
描述 |
|---|---|---|
asset_id |
String |
VOD分配的媒资ID，仅支持查询，不支持修改。 |
状态码： 403
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误描述。 |
请求示例
媒资转码处理
POST https://{endpoint}/v1.0/{project_id}/asset/process
Content-Type: application/json
{
"asset_id": "b4f39691d66cc0ef75d62ee567146e11",
"template_group_name": "test",
"auto_encrypt": 0,
"thumbnail": {
"type": "time",
"time": 12
},
"subtitle_id": [
1
]
}
响应示例
状态码： 202
处理成功返回。
{
"asset_id" : "b4f39691d66cc0ef75d62ee567146e11"
}
状态码： 403
处理失败返回。
{
"error_code" : "VOD.10062",
"error_msg" : "Media asset or resource does not exist, please check."
}
状态码
状态码 |
描述 |
|---|---|
202 |
处理成功返回。 |
403 |
处理失败返回。 |
错误码
请参见错误码。
