本文档介绍为图片添加数据标识。
背景介绍
根据《人工智能生成合成内容标识办法》规定，自2025年9月1日起，所有AI生成的图片、音频、视频等内容均需添加显示标识及隐式标识（如元数据标识或数字水印），以确保内容来源可追溯、可识别。办公安全平台SASE（Secure Access Service Edge）提供CreateWmEmbedTask - 创建水印嵌入任务API，助力企业高效实现内容标识管理，满足合规要求。
图片水印相关参数说明
名称 | 类型 | 必填 | 描述 | 示例值 | |
WmType | string | 是 | 水印类型。取值：
| PureImage | |
Filename | string | 是 | 待嵌入文件的文件名，后端需要根据文件名的后缀判断校验文件类型。 | abc****.pdf | |
FileUrl | string | 是 | 可用于下载待嵌入文件的 URL，需要可以公网访问。 | https://example.com/abc****.pdf | |
WmInfoSize | long | 否 | 水印信息的容量位宽，默认为 32。该参数嵌入和提取时需要保持一致。比如嵌入时使用的是 40 位的 SDK，那么提取时也需要将该值设为 40。 枚举值：
| 32 | |
WmInfoUint | string | 否 | 10 进制数字格式水印信息。若设置该值，则 WmInfoBytesB64 不能设置。 取值范围取决于 WmInfoSize 参数：
| 123*** | |
WmInfoBytesB64 | string | 否 | Base64 编码后的字符串格式水印信息 。若设置该值，则 WmInfoUint 不能设置。 | aGVsbG8gc2F***** | |
ImageEmbedLevel | long | 否 | 图像水印参数：更大的值意味着更高的鲁棒性，但是视觉质量会下降。默认值 2。取值：0~4。 | 2 | |
ImageEmbedJpegQuality | long | 否 | 图像水印参数：期望的输出图像 jpeg 压缩质量因子，默认值 95。取值：1~100。 | 95 | |
ImageControl | object | 否 | 图片水印控制参数。 | ||
TextVisibleControl | object | 否 | 图片文本水印控制参数。 | ||
VisibleText | string | 否 | 文本水印文案。格式为 utf8 字符串。 | 水印文本 | |
Mode | string | 否 | 文本水印显示模式。取值：
| pos | |
Opacity | integer | 否 | 文本水印透明度。取值：1~255。取值越大，越不透明。 | 255 | |
FontSize | long | 否 | 文本水印文字字号。取值越大，字体越大。 | 30 | |
FontColor | string | 否 | 文本水印文字颜色。格式为 0xFFFFFF 或#FFFFFF RGB 颜色格式。如 0x000000 或#000000 表示黑色。 | #FF0000 | |
Angle | long | 否 | 文本水印文字顺针旋转角度。取值范围 0~360。 | 30 | |
PosX | long | 否 | Mode 为 pos 时生效。控制文本水印水平位置的参数，以左上角为原点的像素位置控制。 | 0 | |
PosY | long | 否 | Mode 为 pos 时生效。控制文本水印垂直位置的参数，以左上角为原点的像素位置控制。 | 0 | |
SpaceX | long | 否 | Mode 为 repeat 时生效。控制文本水印平铺水平间距的参数。 | 30 | |
SpaceY | long | 否 | Mode 为 repeat 时生效。控制文本水印平铺垂直间距的参数。 | 0 | |
PosAx | float | 否 | 文本水印水平方向锚点。 取值范围 0~1。(PosAx，PosAy)取值为（0，0）时，以文本左上角为锚点绘制，取值为 0.5，以文本中心点位置绘制，取值为（1，1）时，以文本右下角位置绘制。 | 0 | |
PosAy | float | 否 | 文本水印垂直方向锚点。 取值范围 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 | float | 否 | Mode 为 top-left、top-right 时生效。上边距。 | 0 | |
Right | float | 否 | Mode 为 top-right、bottom-right 时生效。右边距。 | 0 | |
Bottom | float | 否 | Mode 为 bottom-left、bottom-right 时生效。下边距。 | 0 | |
Left | float | 否 | Mode 为 top-left、bottom-left 时生效。左边距。 | 0 | |
LogoVisibleControl | object | 否 | Logo 水印控制参数。 | ||
LogoBase64 | string | 否 | Base64 格式 logo 水印。Logo 文件为 PNG 图片转成 Base64 格式。 | iVBORw0KGgoAAAANSUhEUgAAAMgAAADICA************* | |
Mode | string | 否 | Logo 水印显示模式。取值：
| pos | |
Opacity | integer | 否 | Logo 水印透明度。取值：1~255。取值越大，透明度越低。 | 255 | |
Angle | long | 否 | Logo 水印文字顺针旋转角度。取值范围 1~360。 | 30 | |
PosX | long | 否 | Mode 为 pos 时生效。控制明水印水平位置的参数，以左上角为原点的像素位置控制。 | 0 | |
PosY | long | 否 | Mode 为 pos 时生效。控制明水印垂直位置的参数，以左上角为原点的像素位置控制。 | 0 | |
SpaceX | long | 否 | Mode 为 repeat 时生效。控制明水印平铺水平间距的参数。 | 30 | |
SpaceY | long | 否 | Mode 为 repeat 时生效。控制明水印平铺垂直间距的参数。 | 30 | |
PosAx | float | 否 | Logo 水印水平方向锚点。 取值范围 0~1。(PosAx，PosAy)取值为（0，0）时，以文本左上角为锚点绘制，取值为 0.5，以文本中心点位置绘制，取值为（1，1）时，以文本右下角位置绘制。 | 0 | |
PosAy | float | 否 | 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 | float | 否 | Mode 为 top-left、top-right 时生效。上边距。 | 0 | |
Right | float | 否 | Mode 为 top-right、bottom-right 时生效。右边距。 | 0 | |
Bottom | float | 否 | Mode 为 bottom-left、bottom-right 时生效。下边距。 | 0 | |
Left | float | 否 | Mode 为 top-left、bottom-left 时生效。左边距。 | 0 | |
MetadataControl | object | 否 | 元信息控制参数。WmType 为PureImage 或 AigcImage 时生效。 | ||
XmpKvBase64 | string | 否 | base64格式的元信息。 | QUlHQzp7IkxhYmVsIjoiMSIsIkNvbnRlbnRQcm9kdWNlciI6IkFMSVlVTi1UT05HWUlRSUFOV0VOIiwiUHJvZHVjZUlEIjoiNzQ3MjAzNzQyMDczNDIiLCJQcm9wYWdhdG9yIjoiQUxJWVVOLVRPTkdZSVFJQU5XRU4iLCJQcm9wYXRvcklEIjoiNDU3MjM0NjciLCJSZXNlcnZlQ29kZSI6IjU2MDQ1NzM3In0= | |
Enable | boolean | 否 | 是否启用。 true ： 显示。 false： 不显示。 | true | |
元信息格式说明
XmpKvBase64字段中需要填写base64格式的元信息，在转换为base64格式前，需要满足以下格式要求。
KEY值 | 说明 | Value值示例 |
Label | 表示内容是否由AI生成：
| 1 |
ContentProducer | 服务提供者的编码或名称，用于标识内容的生产者。
详细信息，请参见网络安全标准实践指南。 | 001191******M000100Y43 |
ProduceID | 内容制作编号，用于制作平台溯源合成内容的唯一识别编号。 | 123456 |
ReserveCode1 | 预留字段。 可存储用于生成合成服务提供者自主开展安全防护，保护内容、标识完整性的信息，可通过基于 ContentProducer 与 ProduceID 的哈希机制，实现关键信息的安全存储与校验。 | d41d8cd98f00b204e9800998ecf8427e |
ContentPropagator | 传播平台名称，编号或代码，针对提供人工智能生成合成内容服务，可保持与ContentProducer一致。 | 001191******M000100Y43 |
PropatorID | 内容传播编号，是传播平台对所传播生成合成内容的唯一编号。 | 123456 |
ReserveCode2 | 预留字段。 可用于内容传播服务提供者企业自主开展安全防护，保护内容、标识完整性的信息，可通过基于 ContentProducer 与 ProduceID 的哈希机制，实现关键信息的安全存储与校验。 | d41d8cd98f00b204e9800998ecf8427e |
以某制作平台公司的信息为例：该公司名称为AA，统一社会信用代码：91******M000100Y43。
AIGC: {
"Label": "1",
"ContentProducer": "001191******M000100Y43",
"ProduceID": "123456",
"ReservedCode1": "d41d8cd98f00b204e9800998ecf8427e",
"ContentPropagator": "001191******M000100Y43",
"PropagateID": "123456",
"ReservedCode2": "d41d8cd98f00b204e9800998ecf8427e"
}参考示例
{
"ImageControl": {
"MetadataControl": {
"XmpKvBase64": "QUlHQzp7IkxhYmVsIjoiMSIsIkNvbnRlbnRQcm9kdWNlciI6IjAwMTE5MSoqKioqKk0wMDAxMDBZNDMiLCJQcm9kdWNlSUQiOiIxMjM0NTYiLCJSZXNlcnZlZENvZGUxIjoiZDQxZDhjZDk4ZjAwYjIwNGU5ODAwOTk4ZWNmODQyN2UiLCJDb250ZW50UHJvcGFnYXRvciI6IjAwMTE5MSoqKioqKk0wMDAxMDBZNDMiLCJQcm9wYWdhdGVJRCI6IjEyMzQ1NiIsIlJlc2VydmVkQ29kZTIiOiJkNDFkOGNkOThmMDBiMjA0ZTk4MDA5OThlY2Y4NDI3ZSJ9",
"Enable": true
},
"TextVisibleControl": {
"VisibleText": "AI合成",
"Mode": "bottom-right",
"Opacity": 255,
"FontSize": 40,
"FontColor": "#FFFFFF",
"Visible": true,
"Margin": {
"Right": 20,
"Bottom": 20
}
}
},
"WmType": "PureImage",
"Filename": "IMG_1937.PNG",
"FileUrl": "https://fangtingtest.oss-cn-hangzhou.aliyuncs.com/IMG_1937.PNG?Expires=1757020815&OSSAccessKeyId=TMP.3Kpr************&Signature=hwGQSxItTDS1EeFPGTzB6R3ME6Y%3D",
"WmInfoSize": 32,
"WmInfoUint": "123456"
}实现效果
