ServiceId

String

是

oz***y2

服务 ID。

• 您可以在 veImageX 控制台 服务管理页面，在创建好的图片服务中获取服务 ID。
• 您也可以通过 OpenAPI 的方式获取服务 ID，具体请参考获取所有服务信息。

Algorithm

String

是

default

算法模型，取值如下所示：

• default：文本嵌入基础模型，适用于图片体积增加或画质变化较敏感且水印图不涉及二次编辑的场景，该模型对原图的体积和画质影响最小。。
• adapt_resize：画质自适应文本嵌入模型，适用于图片大规模搬运取证场景，具备较好的抗图片缩放、压缩攻击。
• adapt：文本嵌入自适应模型（AIGC 适用），对画质影响较低，可以抵抗一定程度的分辨率缩放、裁剪、画质压缩等攻击。
• natural: 文本嵌入基础模型（彩色图片通用），适用于图片画质要求不高的原图添加盲水印场景（不建议应用在纯色图片场景），可以抵抗一定程度的图片裁剪和缩放操作，但对画质会产生一定程度影响。建议使用时设置水印强度为中/高强度。

OutQuality

Integer

否

75

输出图片质量参数。取值范围为 [1,100]，默认为 75。 对于 PNG 无损压缩，其他格式下其值越小，压缩率越高，画质越差。

根据所选的盲水印模型和结果图输出格式，图片质量参数的建议值如下所示。

• 指定 Algorithm = default：

  • 当OutFormat = png时，建议OutQuality ≥ 75；

  • 当OutFormat = jpeg时，建议OutQuality ≥ 80；

  • 当OutFormat = webp时，建议OutQuality = 100。

• 指定 Algorithm = adapt_resize：

  • 当OutFormat = png/jpeg/webp时，建议OutQuality ≥ 75。

• 指定 Algorithm = adapt：

  • 当OutFormat = png时，建议OutQuality ≥ 75；

  • 当OutFormat = jpeg时，建议OutQuality ≥ 78；

  • 当OutFormat = webp时，建议OutQuality ≥ 90。

• 指定 Algorithm = natural：

  • 当OutFormat = png/jpeg时，建议OutQuality ≥ 75；

  • 当OutFormat = webp时，建议OutQuality ≥ 90。

您也可根据业务场景适时调整，查看不同参数下处理效果。

StrengthLevel

String

否

strong

算法强度，强度越高，图像抵抗攻击性能越强。取值如下所示：

• low：低强度，适用于纯色图场景以及对图像质量要求高；
• medium：（默认）中强度；
• strong：高强度，适合图像纹理丰富时使用。
  若 Strength 和 StrengthLevel均不为空，则以 Strength 取值为准。

Strength

Integer

否

10

算法强度，取值范围为[10,100]。取值越高，图像抵抗攻击性能越强。

• 若 Strength 和 StrengthLevel均不为空，则以 Strength 取值为准。
• 若 Strength 和 StrengthLevel均为空，则选取 StrengthLevel 的默认值。