Cortador de Imagem
Corte imagens para dimensões específicas ou proporção de aspecto com posicionamento personalizado
Documentação da API
Ponto final da solicitação
Parâmetros da solicitação
| Nome do parâmetro | Tipo | Requerido | Descrição |
|---|---|---|---|
| imageFile | file (Upload necessário) | Sim | Carregue qualquer arquivo de imagem (JPEG, PNG, WebP, GIF, BMP, TIFF) para cortar |
| cropMode | select | Sim | Escolha como cortar sua imagem: quadrado, proporção de aspecto, dimensões exatas ou posicionamento personalizado |
| aspectRatio | select | Não | Selecione uma proporção de aspecto predefinida para cortar. A imagem será cortada para corresponder a esta proporção |
| width | number | Não | Defina a largura exata da área cortada. Será limitada à largura da imagem se maior |
| height | number | Não | Defina a altura exata da área cortada. Será limitada à altura da imagem se maior |
| gravity | select | Não | Choose where to position the crop area. Works with all crop modes |
| x | number | Não | Defina a posição horizontal da área de corte (0 = borda esquerda). Será ajustada se fora dos limites da imagem |
| y | number | Não | Defina a posição vertical da área de corte (0 = borda superior). Será ajustada se fora dos limites da imagem |
| format | select | Não | Escolha o formato de saída ou mantenha o original. Converter para JPEG pode reduzir a qualidade de transparência |
| quality | number | Não | Qualidade de saída para formatos com perda (JPEG, WebP). Maior = melhor qualidade mas arquivo maior |
Os parâmetros de tipo arquivo precisam ser carregados primeiro via POST /upload/image-cropper para obter filePath, depois filePath deve ser passado ao campo de arquivo correspondente.
Formato de resposta
{
"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)"
}
Documentação de MCP
Adicione este ferramenta à sua configuração de servidor MCP:
{
"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://elysiatools.com/mcp/sse?toolId=image-cropper",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}
Você pode encadear várias ferramentas, ex: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máx 20 ferramentas.
Suporta links de arquivos URL ou codificação Base64 para parâmetros de arquivo.
Se você encontrar algum problema, por favor, entre em contato conosco em [email protected]