创建水印模板
功能介绍
创建水印模板。
URI
POST /v1.0/{project_id}/template/watermark
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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方式认证时必选,请求的发生时间。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
水印模板名称。 |
watermark_type |
否 |
String |
水印类型,当前只支持IMAGE(图片水印)。 |
image_process |
否 |
String |
watermark_type设置为IMAGE时有效。 目前包括:
|
dx |
否 |
String |
水印图片相对输出视频的水平偏移量,默认值是0。 设置方法有两种,建议小数型,整数型可能导致控制台图片无法预览,但不影响转码:
|
dy |
否 |
String |
水印图片相对输出视频的垂直偏移量,默认值是0。 设置方法有两种,建议小数型,整数型可能导致控制台图片无法预览,但不影响转码:
|
position |
否 |
String |
水印的位置,默认TOPRIGHT。 目前包括:
|
width |
否 |
String |
水印图片宽,建议小数型,整数型可能导致控制台图片无法预览,但不影响转码。 值有两种形式:
|
height |
否 |
String |
水印图片高,建议小数型,整数型可能导致控制台图片无法预览,但不影响转码。 值有两种形式:
|
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值。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
水印配置模板id |
upload_url |
String |
水印图片上传地址 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误描述。 |
请求示例
创建水印模板
POST https://{endpoint}/v1.0/{project_id}/template/watermark Content-Type: application/json { "name": "test", "type": "PNG" }
响应示例
状态码: 200
处理成功返回
{ "id" : "a52ba84366abebb4c4614e1b16973549", "upload_url" : "https://vod-bucket-26-cn-north-4.obs.cn-north-4.myhuaweicloud.com:443/05ab5cef408026f22f62c018de60cf2e/a52ba84366abebb4c4614e1b16973549/watermark.png?AWSAccessKeyId=MZH0LUL329N1SSXNB3S4&Expires=1625479312&Signature=eF9ERWN5QwuZFUfPdoddHW64Vro%3D" }
状态码: 400
处理失败返回
{ "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }
状态码
状态码 |
描述 |
---|---|
200 |
处理成功返回 |
400 |
处理失败返回 |
错误码
请参见错误码。