AI 助理
备案控制台
官方文档
输入文档关键字查找
首页 办公安全平台 开发参考 API参考 API目录 数字水印 CreateWmEmbedTask - 创建水印嵌入任务

CreateWmEmbedTask - 创建水印嵌入任务

更新时间：
产品详情
我的收藏

创建数字水印嵌入任务。

接口说明

默认最多可创建 500 个用户组。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用前面加 * 表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
csas:CreateWmEmbedTaskcreate
*全部资源
*
    无
无

请求参数

名称类型必填描述示例值
WmTypestring是

水印类型。取值：

  • PureDocument：文档水印。
  • PureImage：图片水印。
  • PureAudio：音频水印。
  • PureVideo：视频水印。
  • AigcDocument：AIGC 文档水印。
  • AigcImage：AIGC 图片水印。
  • AigcAudio：AIGC 音频水印。
  • AigcVideo：AIGC 视频水印。
PureDocument
Filenamestring是

待嵌入文件的文件名，后端需要根据文件名的后缀判断校验文件类型。

abc****.pdf
FileUrlstring是

可用于下载待嵌入文件的 URL，需要可以公网访问。

https://example.com/abc****.pdf
WmInfoSizelong否

水印信息的容量位宽，默认为 32。该参数嵌入和提取时需要保持一致。比如嵌入时使用的是 40 位的 SDK，那么提取时也需要将该值设为 40。

枚举值：
  • 32：32。
  • 40：40。
  • 64：64。
32
WmInfoUintstring否

10 进制数字格式水印信息。若设置该值，则 WmInfoBytesB64 不能设置。

取值范围取决于 WmInfoSize 参数：

  • 当 WmInfoSize 为 32 时，取值范围为 1~4294967295。

  • 当 WmInfoSize 为 40 时，取值范围为 1~1099511627775。

  • 当 WmInfoSize 为 64 时，取值范围为 1~18446744073709551615。

123***
WmInfoBytesB64string否

Base64 编码后的字符串格式水印信息 。若设置该值，则 WmInfoUint 不能设置。

aGVsbG8gc2F*****
VideoIsLongboolean否

视频水印参数：是否使用长视频水印 SDK，默认为 false。取值：

  • true: 是
  • false: 否
false
VideoBitratestring否

短视频水印参数：含义为视频的比特率，默认会自动获取视频的比特率，可以通过该参数强制指定提取时使用的比特率。通常无需设置该参数。

3000k
ImageEmbedLevellong否

图像水印参数：更大的值意味着更高的鲁棒性，但是视觉质量会下降。默认值 2。取值：0~4。

2
ImageEmbedJpegQualitylong否

图像水印参数：期望的输出图像 jpeg 压缩质量因子，默认值 95。取值：1~100。

95
DocumentControlobject否

文档水印控制参数。

InvisibleAntiTextCopyboolean否

是否启用零宽字符暗水印。零宽字符暗水印可以抵抗文档增、删、改、另存（格式不变）、部分文本复制粘贴、CopytoTxt 攻击。不能抵抗格式转换 toPDF 攻击。取值：

  • true：是
  • false：否
true
InvisibleAntiAllCopyboolean否

是否启用组件暗水印。组件暗水印可以抵抗文档增、删、改、另存（格式不变）、docx 全选复制拷贝到新 docx 文档，不能抵抗格式转换攻击。取值：

  • true：是
  • false：否
true
BackgroundControlobject否

背景水印控制参数。

BgAddVisibleboolean否

是否启用背景明水印。取值：

  • true：是
  • false：否
true
BgVisibleControlobject否

背景明水印控制参数。

VisibleTextstring否

背景明水印文案。格式为 utf8 字符串。

hello ****
Modestring否

背景明水印模式。取值：

  • pos：在背景的特定位置嵌入一处明水印文案。
  • repeat：在文档背景中平铺嵌入多处明水印文案。
pos
FontSizelong否

明水印文字字号。取值越大，字体越大。

30
FontColorstring否

明水印文字颜色。格式为 0xFFFFFF RGB 颜色格式。如 0x000000 表示黑色。

0x000000
Anglelong否

明水印文字逆时针旋转角度。取值范围 1~360。

30
PosXstring否

Mode 为 pos 时生效。控制明水印水平位置的参数，以左下角为原点。数值在 0～1 之间时，为比例控制。数值大于 1 时，为精确的像素位置控制。

0.5
PosYstring否

Mode 为 pos 时生效。控制明水印垂直位置的参数，以左下角为原点。数值在 0～1 之间时，为比例控制，数值大于 1 时，为精确的像素位置控制。

0.5
HorizontalNumberlong否

Mode 为 repeat 时生效。表示明水印在水平方向上重复出现的次数。

3
VerticalNumberlong否

Mode 为 repeat 时生效。表示明水印在垂直方向上重复出现的次数。

3
Opacitylong否

明水印透明度参数。取值范围 1~255。取值越大，越不透明。

100
BgAddInvisibleboolean否

是否添加背景暗水印。取值：

  • true：是
  • false：否
true
BgInvisibleControlobject否

背景暗水印控制参数。

Opacitylong否

背景暗水印透明度参数。取值范围 1~13。取值越大，越不透明。

10
CsvControlobject否

CSV 水印控制参数。

Methodstring否

CSV 水印嵌入方法。取值：

  • lossless_row_shift_embed：使用数据无损方法嵌入 CSV 水印，该方法通过调整行顺序实现水印信息嵌入。该方法对最少行数有要求，建议不重复内容不少于 40 行。当提取时，若行数少于 18 行，一定无法提取。
  • lossy_number_embed：使用数据有损方法嵌入 CSV 水印，该方法通过修改 float 值实现水印信息的嵌入。选择该方法时必须指定 EmbedColumn 和 EmbedPrecision 参数。该方法对最少行数有要求，建议不重复内容不少于 100 行。若不重复内容少于 100 行，有一定概率出现无效嵌入，即嵌入后无法提取。
  • lossy_time_stamp_embed：嵌入时间戳水印。
  • lossy_zero_width_embed：嵌入零宽字符水印。
lossless_row_shift_embed
EmbedColumnlong否

有损嵌入控制参数：指定修改列，CSV 文件中该列必须为 float 数据，计数从 1 开始。

1
EmbedPrecisionlong否

有损嵌入控制参数：指定修改精度，表示修改的幅度，为 10 的 n 次方，比如 0 表示修改精度为 10^0，即个位部分，-1 表示小数点后一位，1 表示十位部分，若 float 数据无此精度的部分，则不修改。

0
EmbedTimePositionstring否

时间戳水印参数：控制时间戳水印嵌入位置。取值：

  • Min：分。
  • Sec：秒。
  • MilSec：毫秒。
Min
TimeFormatstring否

时间戳水印参数：解析 csv 文件中时间戳的格式字符串。比如 csv 文件中的时间戳为2023-10-15 13:20:59:342，则对应的格式参数为Year-Mon-Day Hour:Min:Sec.MilSec，水印嵌入后依然按照此格式输出。格式字符串中的年、月、日、时、分、秒、毫秒必须按照上述写法填写，连接符为英文非字符的单连接符，支持以下字符作为连接符：:，/，-， （空格），T，Z。

Year-Mon-Day Hour:Min:Sec.MilSec
EmbedBitsNumberInEachTimelong否

时间戳水印参数：指定单个时间戳容纳多少信息，取值范围 1~4。数字越大，提取信息需要的行数理论上越少，但是修改的时间幅度变大，幅度范围是 2 的 n 次方，n 为此参数值。

1
EmbedDensitystring否

零宽字符水印参数：控制零宽字符嵌入密度，取值范围 0~1，取值越大，嵌入密度越高。0 为仅嵌入第一行内容，1 为所有行均嵌入。

0.1
ImageControlobject否

图片水印控制参数。

TextVisibleControlobject否

图片文本水印控制参数。

VisibleTextstring否

文本水印文案。格式为 utf8 字符串。

水印文本
Modestring否

文本水印显示模式。取值：

  • pos：固定位置模式。
  • repeat：平铺模式。
  • top-left：左上模式。
  • top-right：右上模式。
  • bottom-left：左下模式。
  • bottom-right：右下模式。
pos
Opacityinteger否

文本水印透明度。取值：1~255。取值越大，越不透明。

255
FontSizelong否

文本水印文字字号。取值越大，字体越大。

30
FontColorstring否

文本水印文字颜色。格式为 0xFFFFFF 或#FFFFFF RGB 颜色格式。如 0x000000 或#000000 表示黑色。

#FF0000
Anglelong否

文本水印文字顺针旋转角度。取值范围 0~360。

30
PosXlong否

Mode 为 pos 时生效。控制文本水印水平位置的参数，以左上角为原点的像素位置控制。

0
PosYlong否

Mode 为 pos 时生效。控制文本水印垂直位置的参数，以左上角为原点的像素位置控制。

0
SpaceXlong否

Mode 为 repeat 时生效。控制文本水印平铺水平间距的参数。

30
SpaceYlong否

Mode 为 repeat 时生效。控制文本水印平铺垂直间距的参数。

0
PosAxfloat否

文本水印水平方向锚点。 取值范围 0~1。(PosAx,PosAy)取值为（0,0）时，以文本左上角为锚点绘制；取值为 0.5，以文本中心点位置绘制；取值为（1,1）时，以文本右下角位置绘制。

0
PosAyfloat否

文本水印垂直方向锚点。 取值范围 0~1。(PosAx,PosAy)取值为（0,0）时，以文本左上角为锚点绘制；取值为 0.5，以文本中心点位置绘制；取值为（1,1）时，以文本右下角位置绘制。

0
Visibleboolean否

可见性：

true ： 显示

false： 不显示

true
Marginobject否

Mode 为 top-left、top-right、bottom-left、bottom-right 时生效。边距。

Topfloat否

Mode 为 top-left、top-right 时生效。上边距。

0
Rightfloat否

Mode 为 top-right、bottom-right 时生效。右边距。

0
Bottomfloat否

Mode 为 bottom-left、bottom-right 时生效。下边距。

0
Leftfloat否

Mode 为 top-left、bottom-left 时生效。左边距。

0
LogoVisibleControlobject否

Logo 水印控制参数。

LogoBase64string否

Base64 格式 logo 水印。Logo 文件为 PNG 图片转成 Base64 格式。

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
Modestring否

Logo 水印显示模式。取值：

  • pos：固定位置模式。
  • repeat：平铺模式。
  • top-left：左上模式。
  • top-right：右上模式。
  • bottom-left：左下模式。
  • bottom-right：右下模式。
pos
Opacityinteger否

Logo 水印透明度。取值：1~255。取值越大，透明度越低。

255
Anglelong否

Logo 水印文字顺针旋转角度。取值范围 1~360

30
PosXlong否

Mode 为 pos 时生效。控制明水印水平位置的参数，以左上角为原点的像素位置控制。

0
PosYlong否

Mode 为 pos 时生效。控制明水印垂直位置的参数，以左上角为原点的像素位置控制。

0
SpaceXlong否

Mode 为 repeat 时生效。控制明水印平铺水平间距的参数。

30
SpaceYlong否

Mode 为 repeat 时生效。控制明水印平铺垂直间距的参数。

30
PosAxfloat否

Logo 水印水平方向锚点。 取值范围 0~1。(PosAx,PosAy)取值为（0,0）时，以文本左上角为锚点绘制；取值为 0.5，以文本中心点位置绘制；取值为（1,1）时，以文本右下角位置绘制。

0
PosAyfloat否

Logo 水印垂直方向锚点。 取值范围 0~1。(PosAx,PosAy)取值为（0,0）时，以文本左上角为锚点绘制；取值为 0.5，以文本中心点位置绘制；取值为（1,1）时，以文本右下角为位置绘制。

0
Visibleboolean否

可见性：

true ： 显示

false： 不显示

true
Marginobject否

Mode 为 top-left、top-right、bottom-left、bottom-right 时生效。边距。

Topfloat否

Mode 为 top-left、top-right 时生效。上边距。

0
Rightfloat否

Mode 为 top-right、bottom-right 时生效。右边距。

0
Bottomfloat否

Mode 为 bottom-left、bottom-right 时生效。下边距。

0
Leftfloat否

Mode 为 top-left、bottom-left 时生效。左边距。

0
MetadataControlobject否

元信息控制参数。WmType 为 PureImage 或 AigcImage 时生效。

XmpKvBase64string否

base64 格式的元信息

QUlHQzp7IkxhYmVsIjoiMSIsIkNvbnRlbnRQcm9kdWNlciI6IkFMSVlVTi1UT05HWUlRSUFOV0VOIiwiUHJvZHVjZUlEIjoiNzQ3MjAzNzQyMDczNDIiLCJQcm9wYWdhdG9yIjoiQUxJWVVOLVRPTkdZSVFJQU5XRU4iLCJQcm9wYXRvcklEIjoiNDU3MjM0NjciLCJSZXNlcnZlQ29kZSI6IjU2MDQ1NzM3In0=
Enableboolean否

是否启用。

true ： 显示

false： 不显示

true

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

本次请求的 ID。

BE4FB974-11BC-5453-9BE1-1606A73EACA6
Dataobject

任务信息。

TaskIdstring

任务 ID，用于后续查询任务执行结果。

job:5GfrJYsoaffmCE7Z5bZtjUefzxfd****

示例

正常返回示例

JSON格式

{
  "RequestId": "BE4FB974-11BC-5453-9BE1-1606A73EACA6",
  "Data": {
    "TaskId": "job:5GfrJYsoaffmCE7Z5bZtjUefzxfd****"
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2025-01-14API 内部配置变更，不影响调用查看变更详情
2024-10-29OpenAPI 入参发生变更查看变更详情
上一篇：CreateWmExtractTask - 创建水印提取任务下一篇：其他