POSTPublicimage-blind-watermark-verify

Blind Watermark Verification

Provides an invisible image watermarking service. Covertly embed text watermarks into images via URL or Base64 to protect your copyrights.

Documentation

API Overview

The Blind Watermark Verification API provides the ability to add invisible text watermarks to images. By covertly embedding watermark information in the frequency or spatial domain of an image, it enables copyright protection and tracking. This API supports requests via image URL or Base64 encoding and allows for custom watermark text.

Use Cases

Copyright Protection: Add invisible watermarks to original images and photography to prevent unauthorized use and distribution.
Data Leak Prevention: Embed employee information or timestamps into confidential corporate documents or images to easily track the source of leaks.
Content Tracing: Add platform identifiers or user IDs to user-uploaded images on social media and e-commerce platforms for content tracing.

Request and Response Details

Request Parameters

watermarkContent (Required): The text watermark content. Supports any UTF-8 encoded characters including English letters, numbers, and Chinese characters. Maximum length is 256 characters.
srcUrl (Optional): The URL of the original image. Choose either this or srcBase64.
srcBase64 (Optional): The Base64 encoded string of the original image. Only JPG and PNG formats are supported. Choose either this or srcUrl.

Response

Returns a JSON object containing information about the image with the added blind watermark. For specific response fields, please refer to the detailed API documentation or the actual API response.

Integration Suggestions

Parameter Selection: It is recommended to prioritize using srcUrl to pass images to reduce network transmission overhead. If the image is small or a publicly accessible URL cannot be provided, use srcBase64.
Watermark Content: Design the watermark content reasonably. It is recommended to include information that can uniquely identify the copyright owner or track the source, such as a user ID or company name.
Image Format: Note that srcBase64 only supports JPG and PNG formats. Please validate the format before making an API call.
Error Handling: Properly handle network request exceptions, parameter validation failures, and other scenarios to ensure the stability of your business processes.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

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

Response Example

{}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
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

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
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;