水印与 AIGC 标识

提取图片隐水印

0次调用

5 积分/次

遇到一张疑似被盗用或 AI 生成的图片，想查查它有没有被打过“思想钢印”？直接把图片扔给这个接口，它能把藏在里面的标识完完整整地提取出来。

POST

uapis.cn

/api/v1/watermark/decode

Body

file

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

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

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

url

string

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

image_base64

string

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

ecc

string

纠错强度，必须和嵌入时填的一致，否则无法正确提取。

model_type

string

水印档位，必须和嵌入时用的一致，否则无法正确提取。

功能概述

此接口用于检测图片中是否包含隐形水印，若存在则还原出写入的原始标识内容。即使图片经历过压缩、截取或多次网络转发，也具备较高的成功提取率。接口具备防误判机制，若图片确实未经过处理，会明确返回未检测到结果，而不会强制拼接无效内容。

使用须知

如果您在嵌入水印时修改过进阶参数（如 ecc 或 model_type），在提取时必须传入相同的参数值。若嵌入时使用的是默认配置，此处直接留空即可。

请求体

待检测的图片来源。支持 multipart/form-data 和 application/json。

file

file可选

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

url

string可选

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

image_base64

string可选

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

ecc

string可选

纠错强度，必须和嵌入时填的一致，否则无法正确提取。

model_type

string可选

水印档位，必须和嵌入时用的一致，否则无法正确提取。

名称	类型	属性	说明
`file`	file	可选	要提取水印的图片文件，支持 PNG、JPEG、WebP。
`url`	string	可选	图片链接，需确保公网可直接访问。
`image_base64`	string	可选	图片的 Base64 编码，可携带或省略 data: 前缀。
`ecc`	string	可选	纠错强度，必须和嵌入时填的一致，否则无法正确提取。
`model_type`	string	可选	水印档位，必须和嵌入时用的一致，否则无法正确提取。

响应

200 / 请求成功

读取完成，返回分析与提取结果。

JSON

{
  // 是否在图片中检测到隐形水印。
  "present": true,
  // 还原出来的标识内容（仅在 present=true 时返回）。
  "payload": "a1B2c3D",
  // 检测结果的置信度，取值范围 0-1。
  "confidence": 0.99,
  // 解析耗时（毫秒）。
  "decode_ms": 41.2
}

400 / 错误的请求

参数无效，请检查是否正确提供了图片来源。

JSON

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

503 / 服务不可用

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

JSON

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

快速上手

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

认证方式：

cURL 命令

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

常见问题解答