Media

Blur Background Image Extender

Extend image canvas with blurred background, perfect for portraits, product photos, and professional presentations

file· File resultOpen tool

Quick start

Call this tool from your code in three languages.

cURL

# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/image-extend-blur-background' \
  -F 'file=@/path/to/imageFile.ext'

# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/en/api/tools/image-extend-blur-background' \
  -F 'imageFile=/path/to/file.ext' \
  -F 'uniformPadding=100' \
  -F 'topPadding=0' \
  -F 'rightPadding=0' \
  -F 'bottomPadding=0' \
  -F 'leftPadding=0' \
  -F 'blurStrength=20' \
  -F 'backgroundOpacity=1' \
  -F 'backgroundColor=Select overlay color (optional)...' \
  -F 'format=original' \
  -F 'quality=90'

API reference

Send a POST request with your inputs as JSON. File parameters require a separate upload first.

Endpoint

HTTP

POST https://api.elysiatools.com/en/api/tools/image-extend-blur-background

Parameters

Name	Type	Required	Description
imageFile	fileupload required	Yes	Upload any image file (JPEG, PNG, WebP, TIFF, GIF, BMP)
uniformPadding	number	No	Extension to add on all sides
topPadding	number	No	Extension to add to the top edge
rightPadding	number	No	Extension to add to the right edge
bottomPadding	number	No	Extension to add to the bottom edge
leftPadding	number	No	Extension to add to the left edge
blurStrength	range	No	Strength of the background blur effect (1-100)
backgroundOpacity	range	No	Opacity of background color overlay (0-1)
backgroundColor	color	No	Optional color to blend with blurred background
format	select	No	Choose output format or keep original
quality	number	No	Output quality for lossy formats (JPEG, WebP). Higher = better quality but larger file size

File-type parameters must be uploaded first via POST /upload/image-extend-blur-background, then the returned filePath is passed to the corresponding file field.

Response format

File result

JSON

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

MCP integration

Add this tool to your Model Context Protocol server so AI agents can list and call it.

Server configuration

Add this block to your MCP client configuration:

mcp.json

{
  "mcpServers": {
    "elysiatools-image-extend-blur-background": {
      "name": "image-extend-blur-background",
      "description": "Extend image canvas with blurred background, perfect for portraits, product photos, and professional presentations",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-extend-blur-background",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

List available tools

After connecting to the SSE endpoint, list the exposed tools:

tools/list

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Call this tool

Invoke the tool by its id, passing arguments built from its parameters:

tools/call

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "image-extend-blur-background",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "uniformPadding": 100,
  "topPadding": 0,
  "rightPadding": 0,
  "bottomPadding": 0,
  "leftPadding": 0,
  "blurStrength": 20,
  "backgroundOpacity": 1,
  "backgroundColor": "Select overlay color (optional)...",
  "format": "original",
  "quality": 90
}
  }
}

Chain multiple tools in one session with a comma-separated toolId list, e.g. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (max 20).

File parameters accept a public file URL only (https://…). Local paths, data: URIs, and Base64 strings are not supported.

Questions or issues? Contact [email protected]