Documentation API

Référence API CopySeal

Intégrez le filigranage invisible dans vos applications

Authentification

Toutes les requêtes API nécessitent une authentification via une clé API ou un cookie de session. Incluez votre clé API dans l'en-tête de la requête :

Authorization: Bearer wsk_your_api_key_here

Les clés API sont disponibles avec les formules Business et Enterprise. Les utilisateurs Free et Creator peuvent utiliser le tableau de bord web ou l'authentification par session.

Intégrer un filigrane

Masquez un texte de filigrane invisible dans une image.

POST/embed

Intégrer un filigrane dans un fichier image

Requête

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)
}

Réponse

{
  "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)
}

Exemple (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"

Extraire le filigrane

Révélez le filigrane caché d'une image précédemment intégrée.

POST/extract

Extraire un filigrane d'un fichier image

Requête

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
}

Réponse

{
  "watermark_content": "Copyright 2024"
}

Exemple (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"

Limites de débit

Les limites de débit API dépendent de votre formule d'abonnement.

Formule	Images mensuelles	Taille maximale	Appels API/jour	Limite de lot
Free	5	5MB	--	--
Creator	100	25MB	--	10
Business	500	50MB	100	50
Enterprise	2,000	100MB	Unlimited	500

Codes d'erreur

401Non autorisé - Clé API invalide ou manquante

403Interdit - Fonctionnalité non disponible avec votre formule

429Trop de requêtes - Limite mensuelle d'images atteinte

500Erreur interne du serveur - Le traitement a échoué

Prêt à commencer ?

Créez un compte gratuit et commencez à protéger vos images.

Créer un compte gratuit Voir les tarifs