Design

Composition d'Images

Composer plusieurs images ensemble avec un contrôle précis sur la position, l'opacité et les modes de fusion

file· Résultat fichierOuvrir l'outil

Démarrage rapide

Appelez cet outil depuis votre code en trois langages.

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/fr/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'

Référence de l'API

Envoyez une requête POST avec vos entrées en JSON. Les paramètres de type fichier nécessitent un upload préalable.

Point d'accès

HTTP

POST https://api.elysiatools.com/fr/api/tools/image-composite

Paramètres

Nom	Type	Requis	Description
baseImage	fileupload requis	Oui	Image de base sur laquelle d'autres images seront composées
compositeImages	fileupload requis	Oui	Sélectionner 1-8 images à composer sur l'image de base
layoutMode	select	Oui	Comment disposer les images composées
blendMode	select	Non	Mode de fusion pour les images composées
canvasWidth	number	Non	Largeur de la toile finale (laisser vide pour utiliser la largeur de l'image de base)
canvasHeight	number	Non	Hauteur de la toile finale (laisser vide pour utiliser la hauteur de l'image de base)
backgroundColor	color	Non	Couleur de fond pour les zones transparentes (par défaut : transparent)
outputFormat	select	Non	Format de sortie pour l'image composée
quality	number	Non	Qualité de sortie pour les formats avec perte (JPEG, WebP, AVIF)

Les paramètres de type fichier doivent d'abord être uploadés via POST /upload/image-composite ; le filePath renvoyé est ensuite transmis au champ correspondant.

Format de réponse

Résultat fichier

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)"
}

Intégration MCP

Ajoutez cet outil à votre serveur Model Context Protocol pour que les agents IA puissent le lister et l'appeler.

Configuration du serveur

Ajoutez ce bloc à la configuration de votre client MCP :

mcp.json

{
  "mcpServers": {
    "elysiatools-image-composite": {
      "name": "image-composite",
      "description": "Composer plusieurs images ensemble avec un contrôle précis sur la position, l'opacité et les modes de fusion",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-composite",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Lister les outils disponibles

Après connexion au point d'accès SSE, listez les outils exposés :

tools/list

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Appeler cet outil

Appelez l'outil par son id ; les arguments sont construits à partir de ses paramètres :

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

Chaînez plusieurs outils dans une session avec une liste toolId séparée par des virgules, ex. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (20 max).

Les paramètres fichier acceptent uniquement une URL de fichier publique (https://…). Les chemins locaux, les data: URI et les chaînes Base64 ne sont pas pris en charge.

Des questions ou un problème ? Contactez [email protected]