水印与 AIGC 标识

图片隐形水印嵌入(盲水印)

0次调用
5 积分/次

想给图片打一个肉眼看不见、又很难被抹掉的标识?这个接口会把你指定的标识悄悄写进图片像素里,看不出任何变化,但图片即使被缩放、压缩、在社交平台之间转发,依然能把标识读回来。

功能概述

图片来源三选一:上传 file、传一个 url,或直接传 image_base64payload 是你自己定义、自己管理的标识(比如内容 ID、订单号或一个短码),服务端只负责原样写入、原样读回,不关心它代表什么含义。返回的图片是 Base64 编码,拿到即可直接存储或回传。

使用须知

默认配置已经能给出鲁棒、抗压缩的结果。eccmodel_typestrength 是给老手的微调项,平时留空即可。

payload 越短越稳。建议只写一个短码,完整业务信息存在自己的数据库里,用短码去关联。

  • 输出 JPEG 时用 jpeg_quality 控制质量,输出 PNG 时该参数会被忽略。
  • 同时提供多个图片来源时,优先级为 file > image_base64 > url

错误处理

  • 400 Bad Request:通常是没给图片来源,或漏填了 payload
  • 413 Payload Too Large:图片超过服务端限制,压缩后再试。
  • 503 Service Unavailable:水印服务暂时不可用,稍后重试。

请求体

图片来源和水印参数。file / url / image_base64 至少给一个,payload 必填。multipart/form-data 和 application/json 都支持。

file
file可选

要嵌入水印的图片文件,支持 PNG、JPEG。

url
string可选

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

image_base64
string可选

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

payload
string可选

要嵌入的标识内容,由你自己定义和管理。建议用较短的不透明 ID 或短码,鲁棒性最好。

out_format
string可选

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

jpeg_quality
integer可选

输出为 JPEG 时的质量(1-100),输出 PNG 时忽略。

ecc
string可选

纠错强度档位(高级选项),留空用服务端推荐配置。

model_type
string可选

水印档位(高级选项),在鲁棒性和画质之间权衡,留空用服务端推荐配置。

strength
number可选

水印强度(高级选项),留空用服务端推荐配置。

响应

200 / 请求成功

嵌入成功,返回带水印的图片(Base64)。

JSON

400 / 错误的请求

请求参数错误,比如缺少图片来源或没填 payload。

JSON

413 / 请求实体太大

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

JSON

503 / 服务不可用

水印服务暂时不可用。

JSON