Image Normalize
Normalize image histogram to enhance contrast by stretching the intensity range
API Documentation
Request Endpoint
Request Parameters
| Parameter Name | Type | Required | Description |
|---|---|---|---|
| imageFile | file (Upload required) | Yes | Upload any image file (JPEG, PNG, WebP, GIF, BMP, TIFF) to enhance contrast through histogram normalization |
| autoContrast | checkbox | No | Automatically enhance contrast using 1% and 99% percentiles (recommended for most images) |
| lowerPercentile | range | No | Percentage of darkest pixels to ignore (0.1% - 10%). Lower values preserve more shadow detail |
| upperPercentile | range | No | Percentage of brightest pixels to ignore (90% - 99.9%). Higher values preserve more highlight detail |
| format | select | No | Choose output format or keep original. PNG recommended for maximum quality |
| quality | number | No | Output quality for lossy formats (JPEG, WebP). Higher = better quality but larger file size |
File type parameters need to be uploaded first via POST /upload/image-normalize to get filePath, then pass filePath to the corresponding file field.
Response Format
{
"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)"
}
AI MCP Documentation
Add this tool to your MCP server configuration:
{
"mcpServers": {
"elysiatools-image-normalize": {
"name": "image-normalize",
"description": "Normalize image histogram to enhance contrast by stretching the intensity range",
"baseUrl": "https://elysiatools.com/mcp/sse?toolId=image-normalize",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}
You can chain multiple tools, e.g.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 tools.
Supports URL file links or Base64 encoding for file parameters.
If you encounter any issues, please contact us at [email protected]