Design

Cortar Imagem com Tolerância

Corte avançado de imagem com níveis de tolerância configuráveis para remoção precisa de bordas

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-trim-tolerance' \
  -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-trim-tolerance' \
  -F 'imageFile=/path/to/file.ext' \
  -F 'toleranceMode=absolute' \
  -F 'toleranceValue=40' \
  -F 'autoDetectBackground=true' \
  -F 'backgroundColor=Manual background color (overrides auto-detect)' \
  -F 'scanMethod=full' \
  -F 'edgeSampling=true' \
  -F 'analyzeOnly=false' \
  -F 'format=original' \
  -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-trim-tolerance

Parâmetros

Nome	Tipo	Obrigatório	Descrição
imageFile	fileupload necessário	Sim	Carregue qualquer arquivo de imagem (JPEG, PNG, WebP, TIFF) para corte avançado com tolerância
toleranceMode	select	Sim	Como calcular tolerância de cor para detecção de fundo
toleranceValue	range	Não	Tolerância para detecção de fundo. Maior = mais pixels considerados fundo
autoDetectBackground	checkbox	Não	Analisar bordas da imagem para determinar automaticamente a cor do fundo
backgroundColor	color	Não	Cor de fundo específica para cortar (desativa detecção automática)
scanMethod	select	Não	Como escanear a imagem para encontrar limites de conteúdo
edgeSampling	checkbox	Não	Adicionar preenchimento proporcional à tolerância para evitar cortar conteúdo das bordas
analyzeOnly	checkbox	Não	Analisar configurações de tolerância sem cortar a imagem
format	select	Não	Escolher formato de saída ou manter original
quality	number	Não	Qualidade de saída para formatos com perda (JPEG, WebP). Maior = melhor qualidade mas arquivo maior

Parâmetros do tipo arquivo devem ser enviados primeiro via POST /upload/image-trim-tolerance; 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-trim-tolerance": {
      "name": "image-trim-tolerance",
      "description": "Corte avançado de imagem com níveis de tolerância configuráveis para remoção precisa de bordas",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-trim-tolerance",
      "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-trim-tolerance",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "toleranceMode": "absolute",
  "toleranceValue": 40,
  "autoDetectBackground": true,
  "backgroundColor": "Manual background color (overrides auto-detect)",
  "scanMethod": "full",
  "edgeSampling": true,
  "analyzeOnly": false,
  "format": "original",
  "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]