Elysia Tools Docs
PT
Idioma
ZHESPTRUFRDEEN
Voltar ao site
Explorar ferramentas

Design

Cortador de Imagem

Corte imagens para dimensões específicas ou proporção de aspecto com posicionamento personalizado

file· Resultado de arquivoAbrir ferramenta

Início rápido

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

cURL
# 1) Request a presigned URL → returns { uploadUrl, storageKey }
curl -X POST 'https://api.elysiatools.com/api/upload/presign/image-cropper' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"imageFile.ext","contentType":"application/octet-stream","size":12345}'

# 2) PUT the file bytes directly to the presigned uploadUrl
curl -X PUT '<presigned uploadUrl>' \
  --data-binary @/path/to/file.ext

# 3) Call the tool, passing the returned storageKey for each file field
curl -X POST 'https://api.elysiatools.com/pt/api/tools/image-cropper' \
  -F 'imageFile=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -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'

© 2026 Elysia Tools. Documentação para desenvolvedores.

Voltar ao siteExplorar ferramentas

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

Parâmetros

NomeTipoObrigatórioDescrição
imageFilefileupload necessárioSimCarregue qualquer arquivo de imagem (JPEG, PNG, WebP, GIF, BMP, TIFF) para cortar
cropModeselectSimEscolha como cortar sua imagem: quadrado, proporção de aspecto, dimensões exatas ou posicionamento personalizado
aspectRatioselectNãoSelecione uma proporção de aspecto predefinida para cortar. A imagem será cortada para corresponder a esta proporção
widthnumberNãoDefina a largura exata da área cortada. Será limitada à largura da imagem se maior
heightnumberNãoDefina a altura exata da área cortada. Será limitada à altura da imagem se maior
gravityselectNãoChoose where to position the crop area. Works with all crop modes
xnumberNãoDefina a posição horizontal da área de corte (0 = borda esquerda). Será ajustada se fora dos limites da imagem
ynumberNãoDefina a posição vertical da área de corte (0 = borda superior). Será ajustada se fora dos limites da imagem
formatselectNãoEscolha o formato de saída ou mantenha o original. Converter para JPEG pode reduzir a qualidade de transparência
qualitynumberNãoQualidade 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-cropper; 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-cropper": {
      "name": "image-cropper",
      "description": "Corte imagens para dimensões específicas ou proporção de aspecto com posicionamento personalizado",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-cropper",
      "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-cropper",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "cropMode": "square",
  "aspectRatio": "16:9",
  "width": 0,
  "height": 0,
  "gravity": "center",
  "x": 0,
  "y": 0,
  "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]

Explorar ferramentas
Abrir ferramenta