图像透视变换 —— API 与 MCP | Elysia ToolsDesign
图像透视变换
应用透视变换实现3D效果和透视校正
cURL
# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/image-perspective' \
-F 'file=@/path/to/imageFile.ext'
# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/zh/api/tools/image-perspective' \
-F 'imageFile=/path/to/file.ext' \
-F 'topLeftX=224' \
-F 'topLeftY=96' \
-F 'topRightX=461' \
-F 'topRightY=192' \
-F 'bottomLeftX=64' \
-F 'bottomLeftY=931' \
-F 'bottomRightX=589' \
-F 'bottomRightY=835' \
-F 'background=transparent' \
-F 'format=png' \
-F 'quality=95'
API 参考
以 JSON 形式 POST 提交输入参数。文件类型参数需先单独上传。
请求端点
HTTP
POST https://api.elysiatools.com/zh/api/tools/image-perspective
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
| imageFile | file需先上传 | 是 | 上传任何图片文件(JPEG、PNG、WebP、GIF、BMP、TIFF)进行透视变换 |
| topLeftX | number | 否 | 输出中左上角的X坐标 |
| topLeftY | number | 否 | 输出中左上角的Y坐标 |
| topRightX | number | 否 | 输出中右上角的X坐标 |
| topRightY | number | 否 | 输出中右上角的Y坐标 |
|
| bottomLeftY | number | 否 | 输出中左下角的Y坐标 |
| bottomRightX | number | 否 | 输出中右下角的X坐标 |
| bottomRightY | number | 否 | 输出中右下角的Y坐标 |
| background | text | 否 | 空白区域的背景颜色(十六进制 #RRGGBB 或 #RRGGBBAA,或颜色名称) |
| format | select | 否 | 结果图片的输出格式(PNG推荐用于透明度) |
文件类型参数需先通过 POST /upload/image-perspective 上传,再将返回的 filePath 传入对应的文件字段。
响应格式
文件结果
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)"
}
MCP 集成
将此工具加入你的 Model Context Protocol 服务,让 AI 智能体可以列出并调用它。
服务配置
将以下内容加入你的 MCP 客户端配置:
mcp.json
{
"mcpServers": {
"elysiatools-image-perspective": {
"name": "image-perspective",
"description": "应用透视变换实现3D效果和透视校正",
"baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-perspective",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}
列出可用工具
连接到 SSE 端点后,列出已开放的工具:
tools/list
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}
调用此工具
通过工具 id 调用,参数由其参数表构建:
tools/call
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "image-perspective",
"arguments": {
"imageFile": "https://example.com/file.ext",
"topLeftX": 224,
"topLeftY": 96,
"topRightX": 461,
"topRightY": 192,
"bottomLeftX": 64,
"bottomLeftY": 931,
"bottomRightX": 589,
"bottomRightY": 835,
"background": "transparent",
"format": "png",
"quality": 95
}
}
}
可用逗号分隔的 toolId 在一个会话中串联多个工具,例如 /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp(最多 20 个)。 文件参数仅支持公开的文件链接 URL(https://…)。不支持本地路径、data: URI 和 Base64 字符串。 有问题或反馈?请联系 [email protected]