Media

Batch-Bild-Zuschneiden

Mehrere Bilder auf bestimmte Abmessungen oder Seitenverhältnisse mit benutzerdefinierter Positionierung zuschneiden. Gibt zugeschnittene Bilder als ZIP-Download zurück.

file· DateiergebnisWerkzeug öffnen

Schnellstart

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

cURL

# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/image-batch-crop' \
  -F 'file=@/path/to/imageFiles.ext'

# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/de/api/tools/image-batch-crop' \
  -F 'imageFiles=photo.jpg' \
  -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' \
  -F 'keepOriginalNames=true'

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-batch-crop

Parameter

Name	Typ	Erforderlich	Beschreibung
imageFiles	fileUpload nötig	Ja	—
cropMode	select	Ja	Wählen Sie, wie Sie Bilder zuschneiden möchten: Quadrat, Seitenverhältnis, exakte Abmessungen oder benutzerdefinierte Positionierung
aspectRatio	select	Nein	Wählen Sie ein vordefiniertes Seitenverhältnis zum Zuschneiden
width	number	Nein	Set the exact width for cropped area
height	number	Nein	Set the exact height for cropped area
gravity	select	Nein	Wählen Sie, wo der Zuschneidebereich positioniert werden soll
x	number	Nein	Horizontale Position des Zuschneidebereichs festlegen (0 = linker Rand)
y	number	Nein	Vertikale Position des Zuschneidebereichs festlegen (0 = oberer Rand)
format	select	Nein	Ausgabeformat wählen oder Original beibehalten
quality	number	Nein	Output quality for lossy formats
keepOriginalNames	checkbox	Nein	—

Dateiparameter müssen zuerst per POST /upload/image-batch-crop 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-batch-crop": {
      "name": "image-batch-crop",
      "description": "Mehrere Bilder auf bestimmte Abmessungen oder Seitenverhältnisse mit benutzerdefinierter Positionierung zuschneiden. Gibt zugeschnittene Bilder als ZIP-Download zurück.",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-batch-crop",
      "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-batch-crop",
    "arguments": {
  "imageFiles": [
    "photo.jpg"
  ],
  "cropMode": "square",
  "aspectRatio": "16:9",
  "width": 0,
  "height": 0,
  "gravity": "center",
  "x": 0,
  "y": 0,
  "format": "original",
  "quality": 90,
  "keepOriginalNames": true
}
  }
}

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]