POST已开放image-blind-watermark-verify

盲水印验证

提供图片盲水印添加服务，支持通过URL或Base64传入图片，隐蔽嵌入文字水印，保护版权。

接入文档

接口简介

盲水印验证 API 提供为图片添加不可见文字水印的功能。通过在图片频域或空域中隐蔽嵌入水印信息，实现对图片版权的保护和追踪。该接口支持通过图片的 URL 或 Base64 编码进行请求，并允许自定义水印文字内容。

适用场景

版权保护：为原创图片、摄影作品等添加隐形水印，防止未经授权的盗用和传播。
数据防泄露：在企业内部机密文档或图片中嵌入员工信息或时间戳，便于追踪泄露源头。
内容溯源：在社交媒体、电商平台等场景中，为用户上传的图片添加平台标识或用户 ID，实现内容溯源。

请求与返回说明

请求参数

watermarkContent (必填)：文字水印内容，支持英文、数字、中文等任意 UTF8 编码字符，最大长度 256。
srcUrl (选填)：原图 URL。与 srcBase64 二选一。
srcBase64 (选填)：原图 Base64 编码串，仅支持 JPG、PNG 格式。与 srcUrl 二选一。

返回结果

返回包含添加盲水印后图片信息的 JSON 对象。具体返回字段请参考接口详细文档或实际调用结果。

接入建议

参数选择：建议优先使用 srcUrl 传递图片，以减少网络传输开销。若图片较小或无法提供公网可访问的 URL，可使用 srcBase64。
水印内容：合理设计水印内容，建议包含能够唯一标识版权所有者或追踪源头的信息，如用户 ID、公司名称等。
图片格式：注意 srcBase64 仅支持 JPG 和 PNG 格式，请在调用前进行格式校验。
错误处理：需妥善处理网络请求异常、参数校验失败等情况，确保业务流程的稳定性。

接入示例代码

提供 Shell、Python、Go、Java、PHP 等常见接入示例，便于直接接到现有项目里。

请求示例

{
  "srcBase64": "原图base64串，仅支持JPG, PNG，原图url、base64二选一",
  "srcUrl": "原图url， 原图url、base64二选一"
}

响应示例

{}

请求字段

以下字段根据示例 JSON 自动提取，仅作接入参考。

字段路径	类型	示例值
type	string	object
properties	object	{...}
properties.srcBase64	object	{...}
properties.srcBase64.type	string	string
properties.srcBase64.description	string	原图base64串，仅支持JPG, PNG，原图url、base64二选一
properties.srcUrl	object	{...}
properties.srcUrl.type	string	string

响应字段

以下字段根据示例 JSON 自动提取，仅作接入参考。

字段路径	类型	示例值
type	string	object

curl --request POST \ --url 'https://openapi.toolkk.com/v1/image-blind-watermark-verify' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "srcBase64": "原图base64串，仅支持JPG, PNG，原图url、base64二选一",\n "srcUrl": "原图url，原图url、base64二选一"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/image-blind-watermark-verify" payload = { "srcBase64": "原图base64串，仅支持JPG, PNG，原图url、base64二选一", "srcUrl": "原图url，原图url、base64二选一" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/image-blind-watermark-verify" payload := []byte("{\n \"srcBase64\": \"原图base64串，仅支持JPG, PNG，原图url、base64二选一\",\n \"srcUrl\": \"原图url，原图url、base64二选一\"\n}") req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"srcBase64\": \"原图base64串，仅支持JPG, PNG，原图url、base64二选一\",\n \"srcUrl\": \"原图url，原图url、base64二选一\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/image-blind-watermark-verify")) .method("POST", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/image-blind-watermark-verify'; $payload = "{\n \"srcBase64\": \"原图base64串，仅支持JPG, PNG，原图url、base64二选一\",\n \"srcUrl\": \"原图url，原图url、base64二选一\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;