Design
Schneiden Sie Bilder auf bestimmte Abmessungen oder Seitenverhältnisse mit benutzerdefinierter Positionierung zu
Rufen Sie dieses Werkzeug aus Ihrem Code in drei Sprachen auf.
# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/image-cropper' \
-F 'file=@/path/to/imageFile.ext'
# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/de/api/tools/image-cropper' \
-F 'imageFile=/path/to/file.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'Senden Sie eine POST-Anfrage mit Ihren Eingaben als JSON. Dateiparameter erfordern einen vorherigen Upload.
POST https://api.elysiatools.com/de/api/tools/image-cropper| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| imageFile | fileUpload nötig | Ja | Laden Sie jede Bilddatei (JPEG, PNG, WebP, GIF, BMP, TIFF) zum Zuschneiden hoch |
| cropMode | select | Ja | Wählen Sie, wie Sie Ihr Bild zuschneiden möchten: Quadrat, Seitenverhältnis, exakte Abmessungen oder benutzerdefinierte Positionierung |
| aspectRatio | select | Nein | Wählen Sie ein vordefiniertes Seitenverhältnis zum Zuschneiden. Das Bild wird zugeschnitten, um diesem Verhältnis zu entsprechen |
| width | number | Nein | Stellen Sie die exakte Breite des zugeschnittenen Bereichs ein. Wird auf Bildbreite begrenzt wenn größer |
Fügen Sie dieses Werkzeug Ihrem Model-Context-Protocol-Server hinzu, damit KI-Agenten es auflisten und aufrufen können.
Fügen Sie diesen Block Ihrer MCP-Client-Konfiguration hinzu:
{
"mcpServers": {
"elysiatools-image-cropper": {
"name": "image-cropper",
"description": "Schneiden Sie Bilder auf bestimmte Abmessungen oder Seitenverhältnisse mit benutzerdefinierter Positionierung zu",
"baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-cropper",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}Nach dem Verbinden mit dem SSE-Endpunkt listen Sie die bereitgestellten Werkzeuge auf:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}Rufen Sie das Werkzeug über seine ID auf; Argumente werden aus seiner Parameterliste gebildet:
{
"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
}
}
}| height | number | Nein | Stellen Sie die exakte Höhe des zugeschnittenen Bereichs ein. Wird auf Bildhöhe begrenzt wenn größer |
| gravity | select | Nein | Choose where to position the crop area. Works with all crop modes |
| x | number | Nein | Stellen Sie die horizontale Position des Zuschneidebereichs ein (0 = linker Rand). Wird angepasst wenn außerhalb der Bildgrenzen |
| y | number | Nein | Stellen Sie die vertikale Position des Zuschneidebereichs ein (0 = oberer Rand). Wird angepasst wenn außerhalb der Bildgrenzen |
| format | select | Nein | Wählen Sie Ausgabeformat oder behalten Sie Original. Konvertierung zu JPEG kann Transparenzqualität reduzieren |
| quality | number | Nein | Ausgabequalität für verlustbehaftete Formate (JPEG, WebP). Höher = bessere Qualität aber größere Dateigröße |
Dateiergebnis
{
"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)"
}Fragen oder Probleme? Kontakt: [email protected]