POST已開放image-blind-watermark-verify

盲水印驗證

提供圖片盲水印添加服務，支援透過 URL 或 Base64 傳入圖片，隱蔽嵌入文字水印，保護版權。

接入文件

API 簡介

盲水印驗證 API 提供為圖片添加不可見文字水印的功能。透過在圖片頻域或空域中隱蔽嵌入水印資訊，實現對圖片版權的保護和追蹤。該 API 支援透過圖片的 URL 或 Base64 編碼進行請求，並允許自訂水印文字內容。

適用場景

版權保護：為原創圖片、攝影作品等添加隱形水印，防止未經授權的盜用和傳播。
資料防洩漏：在企業內部機密文件或圖片中嵌入員工資訊或時間戳記，便於追蹤洩漏源頭。
內容溯源：在社群媒體、電商平台等場景中，為使用者上傳的圖片添加平台標識或使用者 ID，實現內容溯源。

請求與回傳說明

請求參數

watermarkContent (必填)：文字水印內容，支援英文、數字、中文等任意 UTF-8 編碼字元，最大長度 256。
srcUrl (選填)：原圖 URL。與 srcBase64 二選一。
srcBase64 (選填)：原圖 Base64 編碼字串，僅支援 JPG、PNG 格式。與 srcUrl 二選一。

回傳結果

回傳包含添加盲水印後圖片資訊的 JSON 物件。具體回傳欄位請參考 API 詳細文件或實際呼叫結果。

串接建議

參數選擇：建議優先使用 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;