DocsICP FilingConsole
Documentation

CreateWmEmbedTask - 创建水印嵌入任务

Updated at:
Copy as MD
Product
My Favorites

创建数字水印嵌入任务。

接口说明

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

调试

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

调试

授权信息

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

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

csas:CreateWmEmbedTask

create

*全部资源

*

 无 无

请求参数

名称

类型

必填

描述

示例值
WmType

string

是

水印类型。取值：

  • PureDocument：文档水印。

  • PureImage：图片水印。

  • PureAudio：音频水印。

  • PureVideo：视频水印。

  • AigcDocument：AIGC 文档水印。

  • AigcImage：AIGC 图片水印。

  • AigcAudio：AIGC 音频水印。

  • AigcVideo：AIGC 视频水印。

枚举值：

  • PureImage :

    图片水印

  • AigcImage :

    AIGC 图片水印

  • AigcAudio :

    AIGC 音频水印

  • PureDocument :

    文档水印

  • PureAudio :

    音频水印

  • PureVideo :

    视频水印

  • AigcDocument :

    AIGC 文档水印

  • AigcVideo :

    AIGC 视频水印

PureDocument
Filename

string

是

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

abc****.pdf
FileUrl

string

是

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

https://example.com/abc****.pdf
WmInfoSize

integer

否

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

枚举值：

  • 32 :

    32

  • 40 :

    40

  • 64 :

    64

32
WmInfoUint

string

否

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

取值范围取决于 WmInfoSize 参数：

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

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

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

123***
WmInfoBytesB64

string

否

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

aGVsbG8gc2F*****
VideoIsLong

boolean

否

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

  • true: 是

  • false: 否

枚举值：

  • true :

    是

  • false :

    否

false
VideoBitrate

string

否

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

3000k
ImageEmbedLevel

integer

否

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

2
ImageEmbedJpegQuality

integer

否

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

95
InvisibleEnable

boolean

否

是否启用嵌入暗水印。默认为 true。 取值：

  • true：是

  • false：否

DocumentControl

object

否

文档水印控制参数。

InvisibleAntiTextCopy

boolean

否

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

  • true：是

  • false：否

枚举值：

  • true :

    是

  • false :

    否

true
InvisibleAntiAllCopy

boolean

否

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

  • true：是

  • false：否

枚举值：

  • true :

    是

  • false :

    否

true
BackgroundControl

object

否

背景水印控制参数。

BgAddVisible

boolean

否

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

  • true：是

  • false：否

true
BgVisibleControl

object

否

背景明水印控制参数。

VisibleText

string

否

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

hello ****
Mode

string

否

背景明水印模式。取值：

  • pos：在背景的特定位置嵌入一处明水印文案。

  • repeat：在文档背景中平铺嵌入多处明水印文案。

pos
FontSize

integer

否

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

30
FontColor

string

否

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

0x000000
Angle

integer

否

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

30
PosX

string

否

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

0.5
PosY

string

否

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

0.5
HorizontalNumber

integer

否

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

3
VerticalNumber

integer

否

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

3
Opacity

integer

否

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

100
BgAddInvisible

boolean

否

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

  • true：是

  • false：否

枚举值：

  • true :

    是

  • false :

    否

true
BgInvisibleControl

object

否

背景暗水印控制参数。

Opacity

integer

否

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

10
CsvControl

object

否

Csv 嵌入水印控制参数。

Method

string

否

水印嵌入方式。 取值：

  • lossless_row_shift_embed：数据无损方法

  • lossy_number_embed：数据有损方法

  • lossy_time_stamp_embed：时间戳方法

  • lossy_zero_width_embed：零宽字符方法

lossy_zero_width_embed
EmbedColumn

integer

否

指定嵌入列，建议为 string 内容列，计数从 1 开始。

1
EmbedPrecision

integer

否

修改精度，表示修改的幅度，为 10 的 n 次方，比如 0 表示修改精度为 10^0，即个位部分，-1 表示小数点后一位，1 表示十位部分，若 float 数据无此精度的部分，则不修改。

-1
EmbedTimePosition

string

否

时间戳水印参数。水印嵌入位置。可以为 Min（分）、Sec（秒）、MilSec（毫秒），三者选一个填入，选择哪个，则算法修改哪个位置的数据。

Sec
TimeFormat

string

否

时间戳水印参数。解析 csv 文件中时间戳的格式字符串。若 csv 文件中的时间戳类似“2023-10-15 13:20:59:342”，则对应的格式字符串为“Year-Mon-Day Hour:Min:Sec.MilSec”，则这里要填“Year-Mon-Day Hour:Min:Sec.MilSec”，水印嵌入后依然按照此格式输出，一旦填错则该方法无法使用。格式字符串中的年、月、日、时、分、秒、毫秒必须按照上述写法填写，连接符为英文非字符的单连接符，一般可以是“:”“/”“-”“ ”（空格），额外支持“T”“Z”为连接符。其他形式的时间格式目前不支持解析。

Hour:Min:Sec
EmbedBitsNumberInEachTime

integer

否

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

2
EmbedDensity

string

否

零宽字符水印参数。嵌入密度，取值在 0～1 之间的浮点数，0 为仅嵌入第一行内容，1 为所有行均嵌入。

1
ImageControl

object

否

图片水印控制参数。

TextVisibleControl

object

否

图片文本水印控制参数。

VisibleText

string

否

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

水印文本
Mode

string

否

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

  • pos：固定位置模式。

  • repeat：平铺模式。

  • top-left：左上模式。

  • top-right：右上模式。

  • bottom-left：左下模式。

  • bottom-right：右下模式。

枚举值：

  • top-right :

    top-right

  • pos :

    pos

  • bottom-right :

    bottom-right

  • bottom-left :

    bottom-left

  • repeat :

    repeat

  • top-left :

    top-left

pos
Opacity

integer

否

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

255
FontSize

integer

否

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

30
FontColor

string

否

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

#FF0000
Angle

integer

否

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

30
PosX

integer

否

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

0
PosY

integer

否

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

0
SpaceX

integer

否

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

30
SpaceY

integer

否

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

0
PosAx

number

否

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

0
PosAy

number

否

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

0
Visible

boolean

否

可见性：

true ： 显示

false： 不显示

true
Margin

object

否

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

Top

number

否

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

0
Right

number

否

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

0
Bottom

number

否

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

0
Left

number

否

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

0
LogoVisibleControl

object

否

Logo 水印控制参数。

Enhance

boolean

否

是否开启增强明水印。开启后会对 logo 进行处理，处理后可以对嵌入 logo 嵌入信息进行提取。

false
LogoBase64

string

否

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

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
Mode

string

否

Logo 水印显示模式。取值：

  • pos：固定位置模式。

  • repeat：平铺模式。

  • top-left：左上模式。

  • top-right：右上模式。

  • bottom-left：左下模式。

  • bottom-right：右下模式。

枚举值：

  • top-right :

    top-right

  • pos :

    pos

  • bottom-right :

    bottom-right

  • bottom-left :

    bottom-left

  • repeat :

    repeat

  • top-left :

    top-left

pos
Opacity

integer

否

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

255
Angle

integer

否

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

30
PosX

integer

否

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

0
PosY

integer

否

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

0
SpaceX

integer

否

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

30
SpaceY

integer

否

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

30
PosAx

number

否

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

0
PosAy

number

否

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

0
Visible

boolean

否

可见性：

true ： 显示

false： 不显示

true
Margin

object

否

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

Top

number

否

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

0
Right

number

否

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

0
Bottom

number

否

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

0
Left

number

否

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

0
MetadataControl

object

否

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

XmpKvBase64

string

否

元信息 Base64 格式。需要将格式为 AIGC:{"Label":"1","ContentProducer":"AXXXX","ProduceID":"BXXXX,"ReservedCode1":"CXXX","ContentPropagator":"DXXX","PropagateID":"EXXX","ReservedCode2":"FXXXX"}。的字符串编码为 Base64 格式字符串。 注意:1. "AIGC:"前缀需要加上，否则无法进行添加，另外需要注意与音视频的格式不同。2.Base64 为标准格式需要，需要有补位。

QUlHQzp7IkxhYmVsIjoiMSIsIkNvbnRlbnRQcm9kdWNlciI6IkFYWFhYIiwiUHJvZHVjZUlEIjoiQlhYWFgsIlJlc2VydmVkQ29kZTEiOiJDWFhYIiwiQ29udGVudFByb3BhZ2F0b3IiOiJEWFhYIiwiUHJvcGFnYXRlSUQiOiJFWFhYIiwiUmVzZXJ2ZWRDb2RlMiI6IkZYWFhYIn0=
Enable

boolean

否

是否启用。

true ： 显示

false： 不显示

枚举值：

  • true :

    true

  • false :

    false

true
VideoControl

object

否

视频控制参数。

TextVisibleControl

object

否

视频文本水印控制参数

VisibleText

string

否

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

水印测试
Mode

string

否

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

  • pos：固定位置，左上角为原点。

  • bottom-right：左下模式。

bottom-right
Opacity

integer

否

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

255
FontSize

integer

否

字体大小，取值范围：0~72。

30
FontColor

string

否

文本水印文字颜色。格式为 0xFFFFFF 或#FFFFFF RGB 颜色格式。

#FF0000
PosX

integer

否

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

10
PosY

integer

否

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

10
Visible

boolean

否

可见性：

true ： 显示

false： 不显示

True
Margin

object

否

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

Bottom

integer

否

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

10
Right

integer

否

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

10
MetadataControl

object

否

元信息控制参数。

XmpKvBase64

string

否

元信息 Base64 格式。需要将格式为 AIGC={"Label":"1","ContentProducer":"AXXXX","ProduceID":"BXXXX,"ReservedCode1":"CXXX","ContentPropagator":"DXXX","PropagateID":"EXXX","ReservedCode2":"FXXXX"}。的字符串编码为 Base64 格式字符串。 注意:1. "AIGC="前缀需要加上，否则无法进行添加，另外需要注意与图片元信息前缀不同。2.Base64 为标准格式需要，需要有补位。

QUlHQz17IkxhYmVsIjoiMSIsIkNvbnRlbnRQcm9kdWNlciI6IkFYWFhYIiwiUHJvZHVjZUlEIjoiQlhYWFgsIlJlc2VydmVkQ29kZTEiOiJDWFhYIiwiQ29udGVudFByb3BhZ2F0b3IiOiJEWFhYIiwiUHJvcGFnYXRlSUQiOiJFWFhYIiwiUmVzZXJ2ZWRDb2RlMiI6IkZYWFhYIn0=
Enable

boolean

否

是否开启。

  • false：未开启。

  • true：已开启。

true
AudioControl

object

否

音频控制参数。

MetadataControl

object

否

音频元信息控制参数。

XmpKvBase64

string

否

元信息 Base64 格式。需要将格式为 AIGC={"Label":"1","ContentProducer":"AXXXX","ProduceID":"BXXXX,"ReservedCode1":"CXXX","ContentPropagator":"DXXX","PropagateID":"EXXX","ReservedCode2":"FXXXX"}。的字符串编码为 Base64 格式字符串。 注意:1. "AIGC="前缀需要加上，否则无法进行添加，另外需要注意与图片元信息前缀不同。2.Base64 为标准格式需要，需要有补位。

QUlHQz17IkxhYmVsIjoiMSIsIkNvbnRlbnRQcm9kdWNlciI6IkFYWFhYIiwiUHJvZHVjZUlEIjoiQlhYWFgsIlJlc2VydmVkQ29kZTEiOiJDWFhYIiwiQ29udGVudFByb3BhZ2F0b3IiOiJEWFhYIiwiUHJvcGFnYXRlSUQiOiJFWFhYIiwiUmVzZXJ2ZWRDb2RlMiI6IkZYWFhYIn0=
Enable

boolean

否

是否开启。

  • false：未开启。

  • true：已开启。

true

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

本次请求的 ID。

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

object

任务信息。

TaskId

string

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

job:5GfrJYsoaffmCE7Z5bZtjUefzxfd****

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

更多信息，参考变更详情。