Documentación API

Referencia API de CopySeal

Integre el marcado de agua invisible en sus aplicaciones

Autenticación

Todas las solicitudes API requieren autenticación mediante una clave API o cookie de sesión. Incluya su clave API en el encabezado de la solicitud:

Authorization: Bearer wsk_your_api_key_here

Las claves API están disponibles en los planes Business y Enterprise. Los usuarios Free y Creator pueden usar el panel web o la autenticación basada en sesión.

Incrustar marca de agua

Oculte texto de marca de agua invisible en una imagen.

POST/embed
Incrustar una marca de agua en un archivo de imagen

Solicitud

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

Respuesta

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

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

Extraer marca de agua

Revele la marca de agua oculta de una imagen previamente incrustada.

POST/extract
Extraer una marca de agua de un archivo de imagen

Solicitud

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
}

Respuesta

{
  "watermark_content": "Copyright 2024"
}

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

Límites de tasa

Los límites de tasa de la API dependen de su plan de suscripción.

PlanImágenes mensualesTamaño máximoLlamadas API/díaLímite de lote
Free55MB----
Creator10025MB--10
Business50050MB10050
Enterprise2,000100MBUnlimited500

Códigos de error

401No autorizado - Clave API inválida o faltante
403Prohibido - Función no disponible en su plan
429Demasiadas solicitudes - Límite mensual de imágenes alcanzado
500Error interno del servidor - El procesamiento falló

¿Listo para comenzar?

Cree una cuenta gratuita y comience a proteger sus imágenes.

Crear cuenta gratuitaVer precios