修改水印模板
功能介绍
修改水印模板
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
PUT /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方式认证时必选,请求的发生时间。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
id |
是 |
String |
水印模板配置id |
name |
是 |
String |
水印模板名称 |
dx |
否 |
String |
水印图片相对输出视频的水平偏移量,默认值是0。 设置方法有两种,建议小数型,整数型可能导致控制台图片无法预览,但不影响转码:
|
dy |
否 |
String |
水印图片相对输出视频的垂直偏移量,默认值是0。 设置方法有两种,建议小数型,整数型可能导致控制台图片无法预览,但不影响转码:
|
position |
否 |
String |
水印的位置,默认TOPRIGHT。 目前包括:
|
width |
否 |
String |
水印图片宽,建议小数型,整数型可能导致控制台图片无法预览,但不影响转码。 值有两种形式:
|
height |
否 |
String |
水印图片高,建议小数型,整数型可能导致控制台图片无法预览,但不影响转码。 值有两种形式:
|
watermark_type |
否 |
String |
水印类型,当前只支持IMAGE(图片水印) |
image_process |
否 |
String |
watermark_type设置为IMAGE时有效。 目前包括:
|
timeline_start |
否 |
String |
水印开始时间,与"timeline_duration"配合使用。 取值范围:[0, END)。"END"表示视频结束时间。 单位:秒。 |
timeline_duration |
否 |
String |
水印持续时间,与"timeline_start"配合使用。 取值范围:(0,END-开始时间]。"END"表示视频结束时间。 单位:秒。 默认:END。 |
响应参数
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误描述。 |
请求示例
修改水印模板
PUT https://{endpoint}/v1.0/{project_id}/template/watermark Content-Type: application/json { "id": "2305739f855413a84af9e6ad6ebb21be", "name": "test" }
响应示例
状态码: 400
处理失败返回。
{ "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }
状态码
状态码 |
描述 |
---|---|
204 |
处理成功返回。 |
400 |
处理失败返回。 |
错误码
请参见错误码。