水印与 AIGC 标识

添加图片隐水印

0次调用

5 积分/次

想给自己的原创图片打上专属烙印，又不想破坏画面美感？或者是为了 AIGC 生成的图片做后续溯源追踪？这个接口能帮您把自定义标识悄悄藏进图片里。

POST

uapis.cn

/api/v1/watermark/embed

Body

file

要加水印的图片文件，支持 PNG、JPEG、WebP。

拖动文件到此处，或点击上传

要加水印的图片文件，支持 PNG、JPEG、WebP。

url

string

图片链接，需确保公网可直接访问。

image_base64

string

图片的 Base64 编码，可携带或省略 data: 前缀。

payload

string

required

需要嵌入图片的隐形标识内容。

out_format

string

输出的图片格式。不填则默认保持与原图一致。

jpeg_quality

integer

输出 JPEG 时的图像质量，范围 1 到 100。

ecc

string

纠错强度，决定水印能抗多少损坏、最多能嵌入多少字符：纠错越强，图片被压缩、裁剪后越容易读回，但能嵌入的字符越少。不填默认 `BCH_4`。

model_type

string

水印档位，在稳健性和画质之间取舍。不填默认 `B`。

strength

number

水印写入强度，默认 1.0。调高更不容易被压缩、转发破坏，但更可能被肉眼看出；调低更隐蔽，但抗损坏能力下降。

功能概述

您可以上传图片并指定一段标识文本，接口会利用算法将这段文本隐形嵌入到图片的像素之中。嵌入后的图片在肉眼看来毫无变化，但能够有效抵抗常见的缩放、裁剪、社交平台压缩与二次转发。适合用于标记图片来源、追踪分发渠道或进行隐蔽的版权确权。

使用须知

容量限制：受限于隐形水印的算法特性，图片能嵌入的字符长度有限（通常为短码）。建议只放入简短的溯源 ID 或特征码，将完整的映射信息存储在您自己的数据库中。

参数说明：提供图片的方式（file / url / image_base64）三选一即可；其他进阶参数如无特殊需求，建议保持留空使用默认最佳配置。

请求体

图片来源与水印内容。支持 multipart/form-data 和 application/json。

file

file可选

要加水印的图片文件，支持 PNG、JPEG、WebP。

url

string可选

图片链接，需确保公网可直接访问。

image_base64

string可选

图片的 Base64 编码，可携带或省略 data: 前缀。

payload

string必填

需要嵌入图片的隐形标识内容。

out_format

string可选

输出的图片格式。不填则默认保持与原图一致。

jpeg_quality

integer可选

输出 JPEG 时的图像质量，范围 1 到 100。

ecc

string可选

纠错强度，决定水印能抗多少损坏、最多能嵌入多少字符：纠错越强，图片被压缩、裁剪后越容易读回，但能嵌入的字符越少。不填默认 `BCH_4`。

model_type

string可选

水印档位，在稳健性和画质之间取舍。不填默认 `B`。

strength

number可选

水印写入强度，默认 1.0。调高更不容易被压缩、转发破坏，但更可能被肉眼看出；调低更隐蔽，但抗损坏能力下降。

名称	类型	属性	说明
`file`	file	可选	要加水印的图片文件，支持 PNG、JPEG、WebP。
`url`	string	可选	图片链接，需确保公网可直接访问。
`image_base64`	string	可选	图片的 Base64 编码，可携带或省略 data: 前缀。
`payload`	string	必填	需要嵌入图片的隐形标识内容。
`out_format`	string	可选	输出的图片格式。不填则默认保持与原图一致。
`jpeg_quality`	integer	可选	输出 JPEG 时的图像质量，范围 1 到 100。
`ecc`	string	可选	纠错强度，决定水印能抗多少损坏、最多能嵌入多少字符：纠错越强，图片被压缩、裁剪后越容易读回，但能嵌入的字符越少。不填默认 `BCH_4`。
`model_type`	string	可选	水印档位，在稳健性和画质之间取舍。不填默认 `B`。
`strength`	number	可选	水印写入强度，默认 `1.0`。调高更不容易被压缩、转发破坏，但更可能被肉眼看出；调低更隐蔽，但抗损坏能力下降。

响应

200 / 请求成功

嵌入成功，返回带有隐形水印的图片数据。

JSON

{
  // 处理完成后的图片 Base64 编码。
  "image_base64": "string",
  // 原始图片文件名（若请求中包含则返回）。
  "image_name": "string",
  // 实际输出的图片格式。
  "format": "png",
  // 实际嵌入的标识内容。
  "payload": "a1B2c3D",
  // 在当前图片和配置下，能够嵌入的最大字符数。
  "capacity_chars": 7,
  // 处理耗时（毫秒）。
  "embed_ms": 118.4
}

400 / 错误的请求

参数无效，请检查是否正确提供了图片及水印内容。

JSON

{
  "code": "INVALID_PARAMETER",
  "message": "请提供有效的图片来源"
}

413 / 请求实体太大

上传的图片过大，请压缩后再试。

JSON

{
  "code": "FILE_TOO_LARGE",
  "message": "图片文件大小超出限制"
}

503 / 服务不可用

服务暂时不可用，请稍后重试。

JSON

{
  "code": "SERVICE_TEMPORARILY_UNAVAILABLE",
  "message": "服务暂时不可用，请稍后重试"
}

快速上手

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

认证方式：

cURL 命令

curl -X POST 'https://uapis.cn/api/v1/watermark/embed' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'payload=a1B2c3D'

常见问题解答

嵌入隐形水印会影响图片的画质吗？

几乎不会。水印通过算法隐蔽写入，正常的视觉浏览与分享均无法察觉到差异。

最多能嵌入多长的文字？

具体容量取决于图片的尺寸与特征。您可以通过响应字段 capacity_chars 查看当前图片支持的最大字符数。推荐使用短码作为溯源凭证。

经过微信、QQ 转发后还能提取出来吗？

接口的默认配置已针对常见社交平台的二次压缩进行了优化。在普通的社交平台转发链路中，通常都能稳定提取出原本的水印内容。

添加图片隐水印

功能概述

使用须知

请求体

响应

200 / 请求成功

400 / 错误的请求

413 / 请求实体太大

503 / 服务不可用

快速上手

cURL 命令

常见问题解答

嵌入隐形水印会影响图片的画质吗？

最多能嵌入多长的文字？

经过微信、QQ 转发后还能提取出来吗？

相关API

提取图片隐水印

添加 AI 生成内容标识

生成 AIGC 服务提供者编码

快速上手

cURL 命令

常见问题解答

嵌入隐形水印会影响图片的画质吗？

最多能嵌入多长的文字？

经过微信、QQ 转发后还能提取出来吗？

相关API

提取图片隐水印

添加 AI 生成内容标识

生成 AIGC 服务提供者编码