Media

Bildhintergrund-Erweiterer

Erweitert die Bildleinwand mit einer einfarbigen Hintergrundfarbe, perfekt für Produktfotos, Social-Media-Inhalte und die Standardisierung von Bilddimensionen

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-extend-background' \
  -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-background' \
  -F 'imageFile=/path/to/file.ext' \
  -F 'extendMode=uniform' \
  -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-background

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
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-background 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-background": {
      "name": "image-extend-background",
      "description": "Erweitert die Bildleinwand mit einer einfarbigen Hintergrundfarbe, perfekt für Produktfotos, Social-Media-Inhalte und die Standardisierung von Bilddimensionen",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-extend-background",
      "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-background",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "extendMode": "uniform",
  "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]