- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
- 用户指南
- 最佳实践
-
API参考
- 使用前必读
- API概览
- 如何调用API
- 应用示例
- 自定义转码模板接口
- 自定义转码模板组接口
- 水印模板接口
- 媒资转码接口
- 转封装接口
- 转动图接口
- 视频解析接口
- 抽帧截图接口
- 独立加密接口
- 授权与配置接口
- 租户开通
- 自定义转码模板接口
- 自定义转码模板组接口
- 水印模板接口
- 媒资转码接口
- 转封装接口
- 转动图接口
- 视频解析接口
- 抽帧截图接口
- 独立加密接口
- 授权与配置接口
- 租户开通
- 自定义转码模板接口
- 自定义转码模板组接口
- 水印模板接口
- 媒资转码接口
- 转封装接口
- 转动图接口
- 视频解析接口
- 抽帧截图接口
- 独立加密接口
- 授权与配置接口
- 租户开通
- 自定义转码模板接口
- 自定义转码模板组接口
- 水印模板接口
- 媒资转码接口
- 转封装接口
- 转动图接口
- 视频解析接口
- 抽帧截图接口
- 独立加密接口
- 授权与配置接口
- 租户开通
- 自定义转码模板接口
- 自定义转码模板组接口
- 水印模板接口
- 媒资转码接口
- 转封装接口
- 转动图接口
- 视频解析接口
- 抽帧截图接口
- 独立加密接口
- 授权与配置接口
- 租户开通
- 附录
- 修订记录
- SDK参考
- 场景代码示例
- 常见问题
- 视频帮助
- 文档下载
- 通用参考
链接复制成功！
更新水印模板
功能介绍
更新自定义水印模板。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
PUT /v1/{project_id}/template/watermark
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。获取方法请参考“获取项目ID”章节。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
否 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
|
Authorization |
否 |
String |
使用AK/SK方式认证时必选，携带的鉴权信息。 |
|
X-Project_Id |
否 |
String |
使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。 |
|
X-Sdk-Date |
否 |
String |
使用AK/SK方式认证时必选，请求的发生时间。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
dx |
否 |
String |
水印图片起点相对输出视频顶点的水平偏移量。 设置方法有如下两种：
示例：输出视频分辨率宽1920，设置“dx”为“0.1”，“referpos”为“TopRight”（右上角），则水印图片右上角到视频右顶点在水平方向上偏移距离为192。 |
|
dy |
否 |
String |
水印图片起点相对输出视频顶点的垂直偏移量。
示例：输出视频分辨率高1080，设置“dy”为“0.1”，“referpos”为“TopRight”（右上角），则水印图片右上角到视频右顶点在垂直方向上的偏移距离为108。 |
|
referpos |
否 |
String |
水印的位置。 取值如下：
|
|
timeline_start |
否 |
String |
水印开始时间，与“timeline_duration”配合使用。 取值范围：数字。 单位：秒。 |
|
timeline_duration |
否 |
String |
水印持续时间，与“timeline_start”配合使用。 取值范围：[数字，ToEND]。“ToEND”表示持续到视频结束。 默认值：ToEND。 |
|
random_time_min |
否 |
Float |
轮转间隔时间最小值，单位：秒 |
|
random_time_max |
否 |
Float |
轮转间隔时间最大值，单位：秒 |
|
image_process |
否 |
String |
图片水印处理方式，type设置为Image时有效。 取值如下：
|
|
width |
否 |
String |
水印图片宽，值有两种形式：
|
|
height |
否 |
String |
水印图片高，值有两种形式：
|
|
base |
否 |
String |
水印叠加母体 取值如下：
|
|
template_id |
否 |
Integer |
水印模板ID |
|
template_name |
否 |
String |
水印模板名称，最大支持64个字符。 |
|
type |
否 |
String |
水印类型，当前只支持Image（图片水印）。后续根据需求再支持Text（文字水印）。 |
响应参数
状态码：403
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 |
|
error_msg |
String |
错误描述。 |
请求示例
更新自定义水印模板。
PUT https://{endpoint}/v1/{project_id}/template/watermark
{
"template_name" : "watermark_1920*1080_10*10_ BottomLeft",
"type" : "Image",
"image_process" : "Grayed",
"width" : "1920",
"height" : "1080",
"dx" : "0.1",
"dy" : "0.1",
"referpos" : "BottomLeft",
"timeline_start" : "6",
"timeline_duration" : "100"
}响应示例
状态码：403
更新水印模板失败
{
"error_code" : "MPC.10202",
"error_msg" : "Invalid request parameter."
}状态码
|
状态码 |
描述 |
|---|---|
|
204 |
更新水印模板成功 |
|
403 |
更新水印模板失败 |
