Design

Bild-Komposition

Komponieren Sie mehrere Bilder zusammen mit präziser Kontrolle über Position, Deckkraft und Mischmodi

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-composite' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"baseImage.ext","contentType":"application/octet-stream","size":12345}'
curl -X POST 'https://api.elysiatools.com/api/upload/presign/image-composite' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"compositeImages.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-composite' \
  -F 'baseImage=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -F 'compositeImages=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -F 'layoutMode=grid' \
  -F 'blendMode=over' \
  -F 'canvasWidth=0' \
  -F 'canvasHeight=0' \
  -F 'backgroundColor=transparent' \
  -F 'outputFormat=png' \
  -F 'quality=95'

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

Parameter

Name	Typ	Erforderlich	Beschreibung
baseImage	fileUpload nötig	Ja	Basisbild, auf das andere Bilder komponiert werden
compositeImages	fileUpload nötig	Ja	1-8 Bilder zum Komponieren auf das Basisbild auswählen
layoutMode	select	Ja	Wie die komponierten Bilder angeordnet werden sollen
blendMode	select	Nein	Mischmodus für komponierte Bilder
canvasWidth	number	Nein	Breite der finalen Leinwand (leer lassen für Basisbildbreite)
canvasHeight	number	Nein	Höhe der finalen Leinwand (leer lassen für Basisbildhöhe)
backgroundColor	color	Nein	Hintergrundfarbe für transparente Bereiche (Standard: transparent)
outputFormat	select	Nein	Ausgabeformat für das komponierte Bild
quality	number	Nein	Ausgabequalität für verlustbehaftete Formate (JPEG, WebP, AVIF)

Dateiparameter müssen zuerst per POST /upload/image-composite 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-composite": {
      "name": "image-composite",
      "description": "Komponieren Sie mehrere Bilder zusammen mit präziser Kontrolle über Position, Deckkraft und Mischmodi",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-composite",
      "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-composite",
    "arguments": {
  "baseImage": "https://example.com/file.ext",
  "compositeImages": "https://example.com/file.ext",
  "layoutMode": "grid",
  "blendMode": "over",
  "canvasWidth": 0,
  "canvasHeight": 0,
  "backgroundColor": "transparent",
  "outputFormat": "png",
  "quality": 95
}
  }
}

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]