Elysia Tools Docs
DE
Sprache
ZHESPTRUFRDEEN
Zurück zur Website
Werkzeuge durchsuchen

Design

Bild-Zuschneider

Schneiden Sie Bilder auf bestimmte Abmessungen oder Seitenverhältnisse mit benutzerdefinierter Positionierung zu

file· DateiergebnisWerkzeug öffnen

Schnellstart

Rufen Sie dieses Werkzeug aus Ihrem Code in drei Sprachen auf.

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/de/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. Entwicklerdokumentation.

Zurück zur WebsiteWerkzeuge durchsuchen

API-Referenz

Senden Sie eine POST-Anfrage mit Ihren Eingaben als JSON. Dateiparameter erfordern einen vorherigen Upload.

Endpunkt

HTTP
POST https://api.elysiatools.com/de/api/tools/image-cropper

Parameter

NameTypErforderlichBeschreibung
imageFilefileUpload nötigJaLaden Sie jede Bilddatei (JPEG, PNG, WebP, GIF, BMP, TIFF) zum Zuschneiden hoch
cropModeselectJaWählen Sie, wie Sie Ihr Bild zuschneiden möchten: Quadrat, Seitenverhältnis, exakte Abmessungen oder benutzerdefinierte Positionierung
aspectRatioselectNeinWählen Sie ein vordefiniertes Seitenverhältnis zum Zuschneiden. Das Bild wird zugeschnitten, um diesem Verhältnis zu entsprechen
widthnumberNeinStellen Sie die exakte Breite des zugeschnittenen Bereichs ein. Wird auf Bildbreite begrenzt wenn größer
heightnumberNeinStellen Sie die exakte Höhe des zugeschnittenen Bereichs ein. Wird auf Bildhöhe begrenzt wenn größer
gravityselectNeinChoose where to position the crop area. Works with all crop modes
xnumberNeinStellen Sie die horizontale Position des Zuschneidebereichs ein (0 = linker Rand). Wird angepasst wenn außerhalb der Bildgrenzen
ynumberNeinStellen Sie die vertikale Position des Zuschneidebereichs ein (0 = oberer Rand). Wird angepasst wenn außerhalb der Bildgrenzen
formatselectNeinWählen Sie Ausgabeformat oder behalten Sie Original. Konvertierung zu JPEG kann Transparenzqualität reduzieren
qualitynumberNeinAusgabequalität für verlustbehaftete Formate (JPEG, WebP). Höher = bessere Qualität aber größere Dateigröße
Dateiparameter müssen zuerst per POST /upload/image-cropper hochgeladen werden; der zurückgegebene filePath wird dann an das entsprechende Feld übergeben.

Antwortformat

Dateiergebnis

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

Fügen Sie dieses Werkzeug Ihrem Model-Context-Protocol-Server hinzu, damit KI-Agenten es auflisten und aufrufen können.

Serverkonfiguration

Fügen Sie diesen Block Ihrer MCP-Client-Konfiguration hinzu:

mcp.json
{
  "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"
    }
  }
}

Verfügbare Werkzeuge auflisten

Nach dem Verbinden mit dem SSE-Endpunkt listen Sie die bereitgestellten Werkzeuge auf:

tools/list
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Dieses Werkzeug aufrufen

Rufen Sie das Werkzeug über seine ID auf; Argumente werden aus seiner Parameterliste gebildet:

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
}
  }
}
Verketten Sie mehrere Werkzeuge in einer Sitzung mit einer kommagetrennten toolId-Liste, z. B. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (max. 20).
Dateiparameter akzeptieren ausschließlich eine öffentliche Datei-URL (https://…). Lokale Pfade, data:-URIs und Base64-Zeichenfolgen werden nicht unterstützt.

Fragen oder Probleme? Kontakt: [email protected]

Werkzeuge durchsuchen
Werkzeug öffnen