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

Design

Bild-Maskierungseffekt

Maskierungseffekte auf Bilder anwenden mit Formen, Verläufen oder benutzerdefinierten Masken für kreative Kompositionen

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-add-masking' \
  -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-add-masking' \
  -F 'imageFile=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -F 'maskType=shape' \
  -F 'maskShape=circle' \
  -F 'maskPosition=center' \
  -F 'maskSize=80' \
  -F 'featherRadius=0' \
  -F 'invertMask=false' \
  -F 'outputFormat=png' \
  -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-add-masking

Parameter

NameTypErforderlichBeschreibung
imageFilefileUpload nötigJaBild für Maskierungseffekt
maskTypeselectNeinTyp der anzuwendenden Maske
maskShapeselectNeinForm der Maske (wenn Maskentyp Form)
maskPositionselectNeinPosition der Maske
maskSizenumberNeinGröße der Maske als Prozentsatz der Bilddimensionen
featherRadiusnumberNeinWeichkantenradius für die Maske (0 für harte Kanten)
invertMaskcheckboxNeinMaskeneffekt invertieren (maskierten Bereich ausblenden)
outputFormatselectNeinAusgabeformat für das Ergebnisbild
qualitynumberNeinAusgabequalität für verlustbehaftete Formate
Dateiparameter müssen zuerst per POST /upload/image-add-masking 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-add-masking": {
      "name": "image-add-masking",
      "description": "Maskierungseffekte auf Bilder anwenden mit Formen, Verläufen oder benutzerdefinierten Masken für kreative Kompositionen",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-add-masking",
      "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-add-masking",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "maskType": "shape",
  "maskShape": "circle",
  "maskPosition": "center",
  "maskSize": 80,
  "featherRadius": 0,
  "invertMask": false,
  "outputFormat": "png",
  "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