create-watermark
Add customizable watermarks or logos to images by specifying URL, opacity, size, and position. Generate a watermarked image URL or save the file directly.
Instructions
Add watermarks/logos to images using QuickChart - get watermarked image URL or save watermarked image to file
Input Schema
Name | Required | Description | Default |
---|---|---|---|
action | Yes | Whether to get watermarked image URL or save as file | |
imageHeight | No | Main image height in pixels | |
imageWidth | No | Main image width in pixels | |
mainImageUrl | Yes | URL of the main image to watermark | |
margin | No | Margin from edges in pixels | |
markHeight | No | Watermark height in pixels | |
markImageUrl | Yes | URL of the watermark/logo image | |
markRatio | No | Watermark size ratio relative to main image | |
markWidth | No | Watermark width in pixels | |
opacity | No | Watermark opacity (0.0 to 1.0) | |
outputPath | No | Path where to save the file (only used with action=save_file) | |
position | No | Watermark position | |
positionX | No | Custom X position in pixels | |
positionY | No | Custom Y position in pixels |
Input Schema (JSON Schema)
{
"properties": {
"action": {
"description": "Whether to get watermarked image URL or save as file",
"enum": [
"get_url",
"save_file"
],
"type": "string"
},
"imageHeight": {
"description": "Main image height in pixels",
"type": "integer"
},
"imageWidth": {
"description": "Main image width in pixels",
"type": "integer"
},
"mainImageUrl": {
"description": "URL of the main image to watermark",
"type": "string"
},
"margin": {
"description": "Margin from edges in pixels",
"type": "integer"
},
"markHeight": {
"description": "Watermark height in pixels",
"type": "integer"
},
"markImageUrl": {
"description": "URL of the watermark/logo image",
"type": "string"
},
"markRatio": {
"description": "Watermark size ratio relative to main image",
"type": "number"
},
"markWidth": {
"description": "Watermark width in pixels",
"type": "integer"
},
"opacity": {
"description": "Watermark opacity (0.0 to 1.0)",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"outputPath": {
"description": "Path where to save the file (only used with action=save_file)",
"type": "string"
},
"position": {
"description": "Watermark position",
"enum": [
"center",
"topLeft",
"topMiddle",
"topRight",
"middleLeft",
"middleRight",
"bottomLeft",
"bottomMiddle",
"bottomRight"
],
"type": "string"
},
"positionX": {
"description": "Custom X position in pixels",
"type": "integer"
},
"positionY": {
"description": "Custom Y position in pixels",
"type": "integer"
}
},
"required": [
"action",
"mainImageUrl",
"markImageUrl"
],
"type": "object"
}