Design
Herramienta de Marca de Agua Añade marcas de agua de texto a imágenes con posición, color, tamaño y transparencia personalizables
file · Resultado de archivo
Inicio rápido Llama a esta herramienta desde tu código en tres lenguajes.
cURL JavaScript Python
cURL
Copiar# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/image-watermark' \
-F 'file=@/path/to/imageFile.ext'
# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/es/api/tools/image-watermark' \
-F 'imageFile=/path/to/file.ext' \
-F 'watermarkText=© Watermark' \
-F 'position=bottom-right' \
-F 'fontSize=40' \
-F 'fontColor=#ffffff' \
-F 'opacity=0.7' \
-F 'rotation=0' \
-F 'backgroundColor=#000000' \
-F 'backgroundOpacity=0.3'
Referencia de la API Envía una petición POST con tus entradas en JSON. Los parámetros de tipo archivo requieren una subida previa.
Endpoint HTTP
CopiarPOST https://api.elysiatools.com/es/api/tools/image-watermark Parámetros Nombre Tipo Obligatorio Descripción imageFile filesubida requerida Sí — watermarkText text Sí — position select Sí — fontSize number No — fontColor color No
Integración MCP Añade esta herramienta a tu servidor Model Context Protocol para que los agentes de IA puedan listarla y llamarla.
Configuración del servidor Añade este bloque a la configuración de tu cliente MCP:
mcp.json
Copiar{
"mcpServers" : {
"elysiatools-image-watermark" : {
"name" : "image-watermark" ,
"description" : "Añade marcas de agua de texto a imágenes con posición, color, tamaño y transparencia personalizables" ,
"baseUrl" : "https://api.elysiatools.com/mcp/sse?toolId=image-watermark" ,
"command" : "" ,
"args" : [],
"env" : {},
"isActive" : true ,
"type" : "sse"
}
}
}Listar herramientas disponibles Tras conectar al endpoint SSE, lista las herramientas expuestas:
tools/list
Copiar{
"jsonrpc" : "2.0" ,
"id" : 1 ,
"method" : "tools/list"
}Llamar a esta herramienta Invoca la herramienta por su id; los argumentos se construyen a partir de sus parámetros:
tools/call
Copiar{
"jsonrpc" : "2.0" ,
"id" : 2 ,
"method" : "tools/call" ,
"params" : {
"name" : "image-watermark" ,
"arguments" : {
"imageFile" : "https://example.com/file.ext" ,
"watermarkText" : "© Watermark" ,
"position" : "bottom-right" ,
"fontSize" : 40 ,
"fontColor" : "#ffffff" ,
"opacity" : 0.7 ,
"rotation" : 0 ,
"backgroundColor" : "#000000" ,
"backgroundOpacity" : 0.3
}
}
}Encadena varias herramientas en una sesión con una lista toolId separada por comas, p. ej. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (máx. 20). backgroundOpacity number No —
Los parámetros de tipo archivo deben subirse primero mediante POST /upload/image-watermark; el filePath devuelto se pasa luego al campo correspondiente.
Formato de respuesta Resultado de archivo
JSON
Copiar{
"filePath" : "/public/processing/randomid.ext" ,
"fileName" : "output.ext" ,
"contentType" : "application/octet-stream" ,
"size" : 1024 ,
"metadata" : {
"key" : "value"
},
"error" : "Error message (optional)" ,
"message" : "Notification message (optional)"
}Los parámetros de archivo aceptan únicamente una URL de archivo pública (https://…). No se admiten rutas locales, data: URI ni cadenas Base64.
Herramienta de Marca de Agua — API y MCP | Elysia Tools