Media

Rognage d'Images par Lot

Rogner plusieurs images à des dimensions spécifiques ou un rapport d'aspect avec un positionnement personnalisé. Renvoie les images rognées en téléchargement ZIP.

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-batch-crop' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"imageFiles.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-batch-crop' \
  -F 'imageFiles=photo.jpg' \
  -F 'cropMode=square' \
  -F 'aspectRatio=16:9' \
  -F 'width=0' \
  -F 'height=0' \
  -F 'gravity=center' \
  -F 'x=0' \
  -F 'y=0' \
  -F 'format=original' \
  -F 'quality=90' \
  -F 'keepOriginalNames=true'

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-batch-crop

Paramètres

Nom	Type	Requis	Description
imageFiles	fileupload requis	Oui	—
cropMode	select	Oui	Choisir comment rogner les images : carré, rapport d'aspect, dimensions exactes ou positionnement personnalisé
aspectRatio	select	Non	Sélectionner un rapport d'aspect prédéfini pour le rognage
width	number	Non	Set the exact width for cropped area
height	number	Non	Set the exact height for cropped area
gravity	select	Non	Choisir où positionner la zone de rognage
x	number	Non	Définir la position horizontale de la zone de rognage (0 = bord gauche)
y	number	Non	Définir la position verticale de la zone de rognage (0 = bord supérieur)
format	select	Non	Choisir le format de sortie ou garder l'original
quality	number	Non	Output quality for lossy formats
keepOriginalNames	checkbox	Non	—

Les paramètres de type fichier doivent d'abord être uploadés via POST /upload/image-batch-crop ; 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-batch-crop": {
      "name": "image-batch-crop",
      "description": "Rogner plusieurs images à des dimensions spécifiques ou un rapport d'aspect avec un positionnement personnalisé. Renvoie les images rognées en téléchargement ZIP.",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-batch-crop",
      "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-batch-crop",
    "arguments": {
  "imageFiles": [
    "photo.jpg"
  ],
  "cropMode": "square",
  "aspectRatio": "16:9",
  "width": 0,
  "height": 0,
  "gravity": "center",
  "x": 0,
  "y": 0,
  "format": "original",
  "quality": 90,
  "keepOriginalNames": true
}
  }
}

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]