API-Dokumentation

CopySeal API-Referenz

Integrieren Sie unsichtbare Wasserzeichen in Ihre Anwendungen

Authentifizierung

Alle API-Anforderungen erfordern eine Authentifizierung über einen API-Schlüssel oder Session-Cookie. Fügen Sie Ihren API-Schlüssel in den Anforderungsheader ein:

Authorization: Bearer wsk_your_api_key_here

API-Schlüssel sind in Business- und Enterprise-Plänen verfügbar. Free- und Creator-Benutzer können das Web-Dashboard oder die sitzungsbasierte Authentifizierung verwenden.

Wasserzeichen einbetten

Unsichtbaren Wasserzeichentext in einem Bild verstecken.

POST/embed
Wasserzeichen in eine Bilddatei einbetten

Anfrage

Content-Type: multipart/form-data

{
  "file":           <binary>,   // Image file (PNG, JPG, WebP, BMP)
  "watermarkText":  "string",   // Text to hide in the image
  "passwordImg":    1,          // Image encryption seed (integer)
  "passwordWm":     1           // Watermark encryption seed (integer)
}

Antwort

{
  "id":           "uuid",
  "wm_shape":     42,           // Key needed for extraction
  "download_url": "https://...", // Presigned download URL
  "expires_at":   "2024-01-02T00:00:00Z"  // URL expiry (null = permanent)
}

Beispiel (cURL)

curl -X POST https://copyseal.ink/embed \
  -H "Authorization: Bearer wsk_your_api_key" \
  -F "file=@photo.png" \
  -F "watermarkText=Copyright 2024" \
  -F "passwordImg=1" \
  -F "passwordWm=1"

Wasserzeichen extrahieren

Das verborgene Wasserzeichen aus einem zuvor eingebetteten Bild offenlegen.

POST/extract
Wasserzeichen aus einer Bilddatei extrahieren

Anfrage

Content-Type: multipart/form-data

{
  "file":        <binary>,  // Image file with embedded watermark
  "wmShape":     42,        // WM Shape key from embedding
  "passwordImg": 1,         // Image encryption seed
  "passwordWm":  1          // Watermark encryption seed
}

Antwort

{
  "watermark_content": "Copyright 2024"
}

Beispiel (cURL)

curl -X POST https://copyseal.ink/extract \
  -H "Authorization: Bearer wsk_your_api_key" \
  -F "file=@watermarked_photo.png" \
  -F "wmShape=42" \
  -F "passwordImg=1" \
  -F "passwordWm=1"

Ratenbegrenzungen

API-Ratenbegrenzungen hängen von Ihrem Abonnementplan ab.

StufeMonatliche BilderMax. DateigrößeAPI-Aufrufe/TagStapellimit
Free55MB----
Creator10025MB--10
Business50050MB10050
Enterprise2,000100MBUnlimited500

Fehlercodes

401Nicht autorisiert - Ungültiger oder fehlender API-Schlüssel
403Verboten - Funktion in Ihrem Plan nicht verfügbar
429Zu viele Anfragen - Monatliches Bildlimit erreicht
500Interner Serverfehler - Verarbeitung fehlgeschlagen

Bereit loszulegen?

Erstellen Sie ein kostenloses Konto und beginnen Sie mit dem Schutz Ihrer Bilder.