You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

复制全文
下载 pdf
明水印
GetVideoWatermarkTemplate
复制全文
下载 pdf
GetVideoWatermarkTemplate
功能描述​
此接口用于查询明水印模板。​
注意事项​
通过子账号使用时,需要授予当前桶的 GetDataProcessTemplate 权限。​
请求消息样式​
​
GET /?process_template&tag=Watermark&id={} HTTP/1.1​
Host: {BucketName}.tos-cn-beijing.volces.com​
Date: Fri, 30 Jul 2021 08:05:36 +0000​
Authorization: authorization string​
​
请求参数和消息头​
​
参数名称​
参数类型​
是否必填​
示例值​
说明​
process_template​
String​
是​
-​
水印模板标识。​
Tag​
String​
是​
Watermark​
任务类型,明水印场景下取值仅为 Watermark。​
​
请求元素​
该请求不使用消息元素。​
响应消息头​
该请求返回的公共响应消息头,请参见公共参数。​
响应元素​
​
参数名称​
参数类型​
是否必填​
示例值​
说明​
Name​
String​
是​
​
atermark-template-1​
用户自定义模板名称:​
  • 仅支持 a-z、A-Z、0-9、_、-和 .,长度不超过 64,开头和结尾字符必须是 a-z、A-Z、0-9。​
  • 多条规则不能重复。​
Watermark​
Container​
是​
-​
水印模板详情信息。​
Type​
String​
是​
Text​
明水印类型:​
  • Text:文字水印。​
  • Image:图片水印。​
父节点:Watermark 。​
Pos​
String​
是​
​
BottomLeft​
基准位置:​
  • TopRight。​
  • TopLeft。​
  • BottomRight。​
  • BottomLeft。​
  • Left。​
  • Right。​
  • Top。​
  • Bottom。​
  • Center。​
父节点:Watermark 。​
LocMode​
String​
是​
Relative​
偏移方式:​
  • Relativity:按比例。​
  • Absolute:固定位置。​
父节点:Watermark 。​
Dx​
Integer​
是​
10​
水平偏移:​
  • 在图片水印中,如果 Background 为 true,当 locMode 为 Relativity 时,为 %,值范围:[-300 0];当 locMode 为 Absolute 时,为 px,值范围:[-4096 0]。​
  • 在图片水印中,如果 Background 为 false,当 locMode 为 Relativity 时,为 %,值范围:[0 100];当 locMode 为 Absolute 时,为 px,值范围:[0 4096]。​
  • 在文字水印中,当 locMode 为 Relativity 时,为 %,值范围:[0 100];当 locMode 为 Absolute 时,为 px,值范围:[0 4096]。​
  • 当 Pos 为 Top、Bottom 和 Center时,该参数无效。​
父节点:Watermark 。​
Dy​
Integer​
是​
10​
垂直偏移:​
  • 在图片水印中,如果 Background 为 true,当 locMode 为 Relativity 时,为 %,值范围:[-300 0];当 locMode 为 Absolute 时,为 px,值范围:[-4096 0]。​
  • 在图片水印中,如果 Background 为 false,当 locMode 为 Relativity 时,为 %,值范围:[0 100];当 locMode 为 Absolute 时,为 px,值范围:[0 4096]。​
  • 在文字水印中,当 locMode 为 Relativity 时,为 %,值范围:[0 100];当 locMode 为 Absolute 时,为 px,值范围:[0 4096]。​
  • 当 Pos 为 Left、Right 和 Center时,该参数无效。​
  • 父节点:Watermark 。​
StartTime​
Integer​
否​
0​
水印开始时间,单位毫秒,默认值为 0。​
父节点:Watermark 。​
EndTime​
Integer​
否​
0​
水印结束时间,单位毫秒,默认值为 0 。​
父节点:Watermark 。​
Text​
Container​
否​
-​
文字水印详情信息。​
父节点:Watermark 。​
FontSize​
Integer​
是​
50​
字体大小,单位 px,值范围 [5, 100]。​
父节点:Text。​
FontType​
​
String​
是​
DejaVu Sans​
字体类型,支持以下字体:​
  • wqy-zenhei:文泉驿正黑。​
  • wqy-microhei:文泉微米黑​
  • fangzhengshusong:方正书宋。​
  • fangzhengkaiti:方正楷体。​
  • fangzhengheiti:方正黑体。​
  • fangzhengfangsong:方正仿宋。​
  • droidsansfallback:DroidSansFallback。​
父节点:Text。​
FontColor​
String​
是​
white​
字体颜色,十六进制 RGB。​
父节点:Text。​
Transparency​
Integer​
是​
50​
水印不透明度,单位 %,值范围 [1, 100]。​
父节点:Text。​
Text​
String​
是​
Test​
​
水印文本内容,长度不超过 64 个字符,仅支持中文、英文、数字、下划线(_)短横线(-)和星号(*)。​
父节点:Text。​
​
请求示例​
​
GET /?process_template&tag=Watermark&id={} HTTP/1.1​
Host: {BucketName}.tos-cn-beijing.volces.com​
Date: Fri, 30 Jul 2021 08:05:36 +0000​
Authorization: authorization string​
​
响应示例​
​
HTTP/1.1 200 OK​
Date: Fri, 30 Jul 2021 13:53:55 GMT​
Content-Type: application/json​
Content-Length: <length>​
Server: TosServer​
x-tos-id-2: 1e89f203jld00006-a444fd0​
x-tos-request-id: 1e89f203b2d00006-a444ed0​
​
{​
"Tag": "Watermark",​
"ID": "313335383161653865396796014bf1349283",​
"Name": "watermark-template-1",​
"WatermarkConfig": {​
"Type": "Text",​
"Pos": "BottomLeft",​
"LocMode": "Relative",​
"Dx": 10,​
"Dy": 10,​
"StartTime": 0,​
"EndTime": 0,​
"Text": {​
"FontSize": 50,​
"FontType": "DejaVu Sans",​
"FontColor": "white",​
"Transparency": 50,​
"Text": "Test"​
}​
}​
}​
​
​
最近更新时间:2026.04.03 17:57:57
这个页面对您有帮助吗?
有用
有用
无用
无用