视频点播 VOD-创建媒资：上传方式:请求参数
下载视频点播 VOD用户手册完整版
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
否 |
String |
用户Token，使用Token鉴权方式时必选。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
|
Authorization |
否 |
String |
使用AK/SK方式认证时必选，携带的鉴权信息。 |
|
X-Sdk-Date |
否 |
String |
使用AK/SK方式认证时必选，请求的发生时间。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
title |
是 |
String |
媒资标题，长度不超过128个字节，UTF-8编码。 |
|
description |
否 |
String |
视频描述，长度不超过1024个字节。 |
|
video_name |
是 |
String |
音视频文件名，长度不超过128个字节。 文件名后缀可选。 |
|
video_type |
是 |
String |
上传音视频文件的格式。 取值如下：
若上传格式为音频文件，则不支持转码、添加水印和字幕。 |
|
category_id |
否 |
Integer |
媒资分类ID。 您可以调用创建媒资分类接口或在点播控制台的分类设置中创建对应的媒资分类，并获取分类ID。
说明：
若不设置或者设置为-1，则上传的音视频归类到系统预置的“其它”分类中。 |
|
video_md5 |
否 |
String |
建议参考《API参考》附录下生成MD5值的媒资上传和更新示例。 |
|
cover_type |
否 |
String |
封面图片文件类型。 取值如下：
上传后的封面名称是固定的，后缀名为封面类型缩写。例如cover0.jpg，cover1.png 若不指定类型，则封面文件无后缀名。
说明：
如果设置了图片格式，则不会执行首帧截图作为封面动作，需自行上传封面。 |
|
cover_md5 |
否 |
String |
封面图片文件MD5值。建议参考《API参考》附录下生成MD5值的媒资上传和更新示例。 |
|
subtitles |
否 |
Array of Subtitle objects |
字幕文件信息 |
|
tags |
否 |
String |
视频标签 。 单个标签不超过24个字节，最多不超过16个标签。 多个用逗号分隔，UTF8编码。 |
|
auto_publish |
否 |
Integer |
是否自动发布。 取值如下：
默认值：1。 |
|
template_group_name |
否 |
String |
转码模板组名称。 若不为空，则使用指定的转码模板对上传的音视频进行转码，您可以在 视频点播 控制台配置转码模板，具体请参见《点播服务用户指南》中的“转码设置”。
说明：
若同时设置了“template_group_name”和“workflow_name”字段，则“template_group_name”字段生效。 |
|
auto_encrypt |
否 |
Integer |
是否自动加密。 取值如下：
默认值：0。 加密与转码必须要一起进行，当需要加密时，转码参数不能为空，且转码输出格式必须要为HLS。 |
|
auto_preheat |
否 |
String |
是否自动预热到CDN。 取值如下：
默认值：0。 |
|
thumbnail |
否 |
Thumbnail object |
截图参数 |
|
review |
否 |
Review object |
媒资审核参数。
说明：
仅“华北-北京一”、“华北-北京四”点播服务支持此功能。 |
|
workflow_name |
否 |
String |
工作流名称。若不为空，则使用指定的工作流对上传的音视频进行处理，您可以在视频点播控制台配置工作流，具体请参见《点播服务用户指南》中的“工作流设置”。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
id |
是 |
Integer |
字幕id。 取值范围：[1,16]。 |
|
type |
是 |
String |
字幕文件类型，目前暂只支持“SRT”和“VTT”。 |
|
language |
是 |
String |
字幕语言类型。 |
|
name |
否 |
String |
字幕文件名称。 |
|
md5 |
否 |
String |
字幕文件的MD5值。 |
|
description |
否 |
String |
字幕描述。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
template_id |
是 |
String |
审核模板ID。您可以在视频点播控制台配置审核模板后获取，具体请参见《点播服务用户指南》中的“审核设置”。
说明：
仅“华北-北京一”、“华北-北京四”点播服务支持此功能。 |
|
interval |
否 |
Integer |
截图检测时间间隔，取值范围为[0,100]，该参数在请求参数中忽略。 |
|
politics |
否 |
Integer |
鉴政内容检测置信度，取值范围为[0,100]，该参数在请求参数中忽略。 置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。 |
|
terrorism |
否 |
Integer |
鉴恐内容的检测置信度，取值范围为[0,100]，该参数在请求参数中忽略。 置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。 |
|
porn |
否 |
Integer |
鉴黄内容的检测置信度，取值范围为[0,100]，该参数在请求参数中忽略。 置信度越高，说明审核结果越可信。未开启或设置为0时，表示未进行此项检测。 |
