Design

Gerador de Mapa de Profundidade

Gera mapas de profundidade a partir de imagens usando análise de brilho, saturação e bordas. Cria mapas de profundidade em escala de cinza onde pixels mais claros indicam objetos mais próximos e pixels mais escuros indicam objetos mais distantes.

file· Resultado de arquivoAbrir ferramenta

Início rápido

Chame esta ferramenta a partir do seu código em três idiomas.

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/pt/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'

Referência da API

Envie uma requisição POST com suas entradas em JSON. Parâmetros do tipo arquivo exigem upload prévio.

Endpoint

HTTP

POST https://api.elysiatools.com/pt/api/tools/image-depth-map

Parâmetros

Nome	Tipo	Obrigatório	Descrição
imageFile	fileupload necessário	Sim	Carregue uma imagem para gerar seu mapa de profundidade
method	select	Não	Algoritmo usado para calcular valores de profundidade
invert	checkbox	Não	Inverter o mapa de profundidade (escuro = perto, claro = longe)
edgeEnhancement	checkbox	Não	Aplica detecção de bordas para melhorar limites de objetos no mapa de profundidade
blur	range	Não	Aplica desfoque gaussiano para suavizar o mapa de profundidade
brightnessWeight	range	Não	Quanto o brilho afeta o cálculo de profundidade (apenas modo combinado)
saturationWeight	range	Não	Quanto a saturação de cor afeta o cálculo de profundidade (apenas modo combinado)
edgeWeight	range	Não	Quanto as bordas afetam o cálculo de profundidade (apenas modo combinado)
format	select	Não	Formato de imagem de saída para o mapa de profundidade
quality	number	Não	Configuração de qualidade para formatos com perda (JPEG, WebP)

Parâmetros do tipo arquivo devem ser enviados primeiro via POST /upload/image-depth-map; o filePath retornado é então passado ao campo correspondente.

Formato de resposta

Resultado de arquivo

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

Integração MCP

Adicione esta ferramenta ao seu servidor Model Context Protocol para que agentes de IA possam listá-la e chamá-la.

Configuração do servidor

Adicione este bloco à configuração do seu cliente MCP:

mcp.json

{
  "mcpServers": {
    "elysiatools-image-depth-map": {
      "name": "image-depth-map",
      "description": "Gera mapas de profundidade a partir de imagens usando análise de brilho, saturação e bordas. Cria mapas de profundidade em escala de cinza onde pixels mais claros indicam objetos mais próximos e pixels mais escuros indicam objetos mais distantes.",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-depth-map",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Listar ferramentas disponíveis

Após conectar ao endpoint SSE, liste as ferramentas expostas:

tools/list

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

Chamar esta ferramenta

Invoque a ferramenta pelo seu id; os argumentos são construídos a partir de seus parâmetros:

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
}
  }
}

Encadeie várias ferramentas em uma sessão com uma lista toolId separada por vírgulas, p. ex. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (máx. 20).

Parâmetros de arquivo aceitam somente uma URL de arquivo pública (https://…). Caminhos locais, data: URI e strings Base64 não são suportados.

Dúvidas ou problemas? Contate [email protected]