水印与 AIGC 标识

AI 生成内容标识（AIGC 合规 · GB 45438）

0次调用

5 积分/次

要在国内合规地分发 AI 生成的图片，绕不开 GB 45438-2025《网络安全技术人工智能生成合成内容标识方法》——这份强制性国家标准规定了 AI 生成合成内容应当如何标识。这个接口把三层标识打包在一起——文件元数据隐式标识、可见角标、隐形水印，一次调用就能快速满足标准的标识要求。

三层标识

文件元数据隐式标识（默认写入）：把标准规定的 AIGC 信息写进图片文件元数据，包含内容标签和服务提供者编码。
可见角标（可选）：在角落叠加一行“AI 生成”之类的可见文字；字符高度会自动保持不低于画面最短边的 5%，正好满足标准对显式标识的尺寸要求。
隐形水印（可选）：在像素层压入抗压缩的隐形水印，便于日后溯源核验。

使用须知

content_producer 必填，要传一个合法的 27 位服务提供者编码。不知道怎么拼？先用下方的「服务提供者编码」接口生成一个。

处理顺序固定为：隐形水印 → 可见角标 → 写元数据，三层互不干扰。返回里的applied 会列出本次实际写入了哪几层。

至少要打一层标识：默认会写元数据；如果设 skip_metadata=true，就必须再开启 explicit_label 或 embed_watermark 其中之一，否则请求会被拒绝。

错误处理

400 Bad Request：常见于缺少图片来源、content_producer 不合法，或一层标识都没打。
413 Payload Too Large：图片超过服务端限制。
503 Service Unavailable：水印服务暂时不可用。

请求体

图片来源和标识参数。file / url / image_base64 至少给一个，content_producer 必填。multipart/form-data 和 application/json 都支持。

file

file可选

要打标的图片文件，支持 PNG、JPEG。

url

string可选

图片的 URL 地址，需要是公网能直接访问的链接。

image_base64

string可选

图片的 Base64 编码，可以不带 data URI 前缀。

content_producer

string可选

生成合成服务提供者的 27 位编码（必填）。由你按自己的主体身份生成，可用“服务提供者编码”接口生成或校验。

label

string可选

内容标签：'1'=人工智能生成合成，'2'=人机协同（人工创作经 AI 编辑），'3'=其他 AI 参与。留空默认 '1'。

produce_id

string可选

生成内容编号（可选）。

content_propagator

string可选

内容传播服务提供者的 27 位编码（可选），传了同样会做格式校验。

propagate_id

string可选

传播内容编号（可选）。

skip_metadata

boolean可选

是否跳过写入文件元数据隐式标识。默认 false（写入）。设为 true 时，必须至少开显式角标或隐形水印其中一个。

explicit_label

boolean可选

是否叠加显式角标。默认 false。

explicit_text

string可选

显式角标文字，留空默认“AI 生成”。

explicit_position

string可选

显式角标位置，留空默认右下角。

explicit_height_ratio

number可选

显式角标字符高度相对画面最短边的比例，低于 0.05 会被自动抬到 0.05 以满足国标要求。

embed_watermark

boolean可选

是否叠加隐形水印。默认 false。

watermark_payload

string可选

隐形水印的标识内容，当 embed_watermark=true 时必填。

out_format

string可选

输出图片格式，留空就跟随输入格式。

jpeg_quality

integer可选

输出为 JPEG 时的质量（1-100），输出 PNG 时忽略。

名称	类型	属性	说明
`file`	file	可选	要打标的图片文件，支持 PNG、JPEG。
`url`	string	可选	图片的 URL 地址，需要是公网能直接访问的链接。
`image_base64`	string	可选	图片的 Base64 编码，可以不带 data URI 前缀。
`content_producer`	string	可选	生成合成服务提供者的 27 位编码（必填）。由你按自己的主体身份生成，可用“服务提供者编码”接口生成或校验。
`label`	string	可选	内容标签：'1'=人工智能生成合成，'2'=人机协同（人工创作经 AI 编辑），'3'=其他 AI 参与。留空默认 '1'。
`produce_id`	string	可选	生成内容编号（可选）。
`content_propagator`	string	可选	内容传播服务提供者的 27 位编码（可选），传了同样会做格式校验。
`propagate_id`	string	可选	传播内容编号（可选）。
`skip_metadata`	boolean	可选	是否跳过写入文件元数据隐式标识。默认 false（写入）。设为 true 时，必须至少开显式角标或隐形水印其中一个。
`explicit_label`	boolean	可选	是否叠加显式角标。默认 false。
`explicit_text`	string	可选	显式角标文字，留空默认“AI 生成”。
`explicit_position`	string	可选	显式角标位置，留空默认右下角。
`explicit_height_ratio`	number	可选	显式角标字符高度相对画面最短边的比例，低于 0.05 会被自动抬到 0.05 以满足国标要求。
`embed_watermark`	boolean	可选	是否叠加隐形水印。默认 false。
`watermark_payload`	string	可选	隐形水印的标识内容，当 embed_watermark=true 时必填。
`out_format`	string	可选	输出图片格式，留空就跟随输入格式。
`jpeg_quality`	integer	可选	输出为 JPEG 时的质量（1-100），输出 PNG 时忽略。

响应

200 / 请求成功

打标成功，返回带标识的图片（Base64）。

JSON

400 / 错误的请求

请求参数错误，比如缺少图片来源、content_producer 不合法，或者一层标都没打。

JSON

413 / 请求实体太大

图片过大，超过服务端限制。

JSON

503 / 服务不可用

水印服务暂时不可用。

JSON

快速上手

选择你的语言查看调用示例

认证方式：

cURL 命令

curl -X POST 'https://uapis.cn/api/v1/watermark/label' \
  -H 'Authorization: Bearer YOUR_API_KEY'

常见问题解答

content_producer 为什么必须填？

GB 45438-2025 把服务提供者编码列为文件元数据隐式标识的必备要素，所以得由你按自己的主体身份提供这个 27 位编码。可以先用“服务提供者编码”接口生成。

我只想写元数据、不要可见角标行不行？

行。默认就只写文件元数据隐式标识，显式角标和隐形水印都是可选项，要哪个开哪个。

显式角标的字号有硬性要求吗？

有。国标要求显式文字标识的字符高度不低于画面最短边的 5%，接口会自动保证这个下限，不用你自己算。

上一篇图片隐形水印提取（盲水印读取）

下一篇AIGC 服务提供者编码生成与校验