图片裁剪
裁剪图片到指定尺寸或宽高比，支持自定义定位
API 文档
请求端点
POST /zh/api/tools/image-cropper
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| imageFile | file (需要先上传) | 是 | 上传任何图片文件（JPEG、PNG、WebP、GIF、BMP、TIFF）进行裁剪 |
| cropMode | select | 是 | 选择裁剪方式：正方形、宽高比、精确尺寸或自定义定位 |
| aspectRatio | select | 否 | 选择预定义的宽高比进行裁剪。图片将被裁剪以匹配此比例 |
| width | number | 否 | 设置裁剪区域的精确宽度。如果超过图片宽度将自动限制 |
| height | number | 否 | 设置裁剪区域的精确高度。如果超过图片高度将自动限制 |
| gravity | select | 否 | Choose where to position the crop area. Works with all crop modes |
| x | number | 否 | 设置裁剪区域的水平位置（0 = 左边缘）。如果超出图片边界将自动调整 |
| y | number | 否 | 设置裁剪区域的垂直位置（0 = 顶部边缘）。如果超出图片边界将自动调整 |
| format | select | 否 | 选择输出格式或保持原格式。转换为JPEG可能会降低透明度质量 |
| quality | number | 否 | 有损格式（JPEG、WebP）的输出质量。越高 = 质量越好但文件越大 |
文件类型参数需要先通过 POST /upload/image-cropper 上传获取 filePath，然后将 filePath 传递给对应的文件字段。
响应格式
{
"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)"
}
文件:
文件
AI MCP 文档
将此工具添加到您的 MCP 服务器配置中：
{
"mcpServers": {
"elysiatools-image-cropper": {
"name": "image-cropper",
"description": "裁剪图片到指定尺寸或宽高比，支持自定义定位",
"baseUrl": "https://elysiatools.com/mcp/sse?toolId=image-cropper",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}
你可以串联多个工具，比如：`https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`，最多20个。
支持 URL 文件链接或 Base64 编码作为文件参数。
如果遇见问题，请联系我们：[email protected]