Media

Corte de Imagens em Lote

Cortar múltiplas imagens para dimensões específicas ou proporção de aspecto com posicionamento personalizado. Retorna imagens cortadas como download ZIP.

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-batch-crop' \
  -F 'file=@/path/to/imageFiles.ext'

# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/pt/api/tools/image-batch-crop' \
  -F 'imageFiles=photo.jpg' \
  -F 'cropMode=square' \
  -F 'aspectRatio=16:9' \
  -F 'width=0' \
  -F 'height=0' \
  -F 'gravity=center' \
  -F 'x=0' \
  -F 'y=0' \
  -F 'format=original' \
  -F 'quality=90' \
  -F 'keepOriginalNames=true'

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-batch-crop

Parâmetros

Nome	Tipo	Obrigatório	Descrição
imageFiles	fileupload necessário	Sim	—
cropMode	select	Sim	Escolher como cortar imagens: quadrado, proporção de aspecto, dimensões exatas ou posicionamento personalizado
aspectRatio	select	Não	Selecionar uma proporção de aspecto predefinida para cortar
width	number	Não	Set the exact width for cropped area
height	number	Não	Set the exact height for cropped area
gravity	select	Não	Escolher onde posicionar a área de corte
x	number	Não	Definir posição horizontal da área de corte (0 = borda esquerda)
y	number	Não	Definir posição vertical da área de corte (0 = borda superior)
format	select	Não	Escolher formato de saída ou manter original
quality	number	Não	Output quality for lossy formats
keepOriginalNames	checkbox	Não	—

Parâmetros do tipo arquivo devem ser enviados primeiro via POST /upload/image-batch-crop; 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-batch-crop": {
      "name": "image-batch-crop",
      "description": "Cortar múltiplas imagens para dimensões específicas ou proporção de aspecto com posicionamento personalizado. Retorna imagens cortadas como download ZIP.",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-batch-crop",
      "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-batch-crop",
    "arguments": {
  "imageFiles": [
    "photo.jpg"
  ],
  "cropMode": "square",
  "aspectRatio": "16:9",
  "width": 0,
  "height": 0,
  "gravity": "center",
  "x": 0,
  "y": 0,
  "format": "original",
  "quality": 90,
  "keepOriginalNames": true
}
  }
}

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]