Design

Depth Map Generator

Generate depth maps from images using brightness, saturation, and edge analysis. Creates grayscale depth maps where lighter pixels indicate closer objects and darker pixels indicate further objects.

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-depth-map' \
  -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-depth-map' \
  -F 'imageFile=/path/to/file.ext' \
  -F 'method=combined' \
  -F 'invert=false' \
  -F 'edgeEnhancement=true' \
  -F 'blur=1' \
  -F 'brightnessWeight=0.5' \
  -F 'saturationWeight=0.3' \
  -F 'edgeWeight=0.2' \
  -F 'format=png' \
  -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-depth-map

Parameters

Name	Type	Required	Description
imageFile	fileupload required	Yes	Upload an image to generate its depth map
method	select	No	Algorithm used to calculate depth values
invert	checkbox	No	Invert the depth map (dark = close, light = far)
edgeEnhancement	checkbox	No	Apply edge detection to enhance object boundaries in depth map
blur	range	No	Apply gaussian blur to smooth the depth map
brightnessWeight	range	No	How much brightness affects depth calculation (combined mode only)
saturationWeight	range	No	How much color saturation affects depth calculation (combined mode only)
edgeWeight	range	No	How much edges affect depth calculation (combined mode only)
format	select	No	Output image format for depth map
quality	number	No	Quality setting for lossy formats (JPEG, WebP)

File-type parameters must be uploaded first via POST /upload/image-depth-map, 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-depth-map": {
      "name": "image-depth-map",
      "description": "Generate depth maps from images using brightness, saturation, and edge analysis. Creates grayscale depth maps where lighter pixels indicate closer objects and darker pixels indicate further objects.",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-depth-map",
      "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-depth-map",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "method": "combined",
  "invert": false,
  "edgeEnhancement": true,
  "blur": 1,
  "brightnessWeight": 0.5,
  "saturationWeight": 0.3,
  "edgeWeight": 0.2,
  "format": "png",
  "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]