Media

Bild-Leinwand-Erweiterer

Basis-Tool zur Erweiterung der Bildleinwand zum Hinzufügen von Raum um Bilder mit verschiedenen Füllstrategien

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-extend' \
  -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-extend' \
  -F 'imageFile=/path/to/file.ext' \
  -F 'extendMode=uniform' \
  -F 'extendWith=background' \
  -F 'backgroundColor=#ffffff' \
  -F 'uniformPadding=50' \
  -F 'topPadding=0' \
  -F 'rightPadding=0' \
  -F 'bottomPadding=0' \
  -F 'leftPadding=0' \
  -F 'format=original' \
  -F 'quality=90'

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

Parameter

Name	Typ	Erforderlich	Beschreibung
imageFile	fileUpload nötig	Ja	Laden Sie eine Bilddatei hoch (JPEG, PNG, WebP, TIFF, GIF, BMP)
extendMode	select	Ja	Wählen Sie, wie Sie die Bildleinwand erweitern möchten
extendWith	select	Ja	Wählen Sie, wie Sie den erweiterten Bereich füllen möchten
backgroundColor	color	Nein	Hintergrundfarbe für den erweiterten Bereich (Standard: Weiß)
uniformPadding	number	Nein	Auffüllung für alle Seiten bei gleichmäßigem Modus
topPadding	number	Nein	Auffüllung für den oberen Rand
rightPadding	number	Nein	Auffüllung für den rechten Rand
bottomPadding	number	Nein	Auffüllung für den unteren Rand
leftPadding	number	Nein	Auffüllung für den linken Rand
format	select	Nein	Wählen Sie das Ausgabeformat oder behalten Sie das Original
quality	number	Nein	Ausgabequalität für verlustbehaftete Formate (JPEG, WebP). Höher = bessere Qualität aber größere Datei

Dateiparameter müssen zuerst per POST /upload/image-extend 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-extend": {
      "name": "image-extend",
      "description": "Basis-Tool zur Erweiterung der Bildleinwand zum Hinzufügen von Raum um Bilder mit verschiedenen Füllstrategien",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-extend",
      "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-extend",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "extendMode": "uniform",
  "extendWith": "background",
  "backgroundColor": "#ffffff",
  "uniformPadding": 50,
  "topPadding": 0,
  "rightPadding": 0,
  "bottomPadding": 0,
  "leftPadding": 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]