Elysia Tools Docs
FR
Langue
ZHESPTRUFRDEEN
Retour au site
Parcourir les outils

Design

Rogneur d'Image

Recadrez des images à des dimensions spécifiques ou un rapport d'aspect avec un positionnement personnalisé

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-cropper' \
  -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/fr/api/tools/image-cropper' \
  -F 'imageFile=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -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'

© 2026 Elysia Tools. Documentation développeur.

Retour au siteParcourir les outils

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

Paramètres

NomTypeRequisDescription
imageFilefileupload requisOuiTéléchargez tout fichier image (JPEG, PNG, WebP, GIF, BMP, TIFF) à rogner
cropModeselectOuiChoisissez comment rogner votre image : carré, rapport d'aspect, dimensions exactes ou positionnement personnalisé
aspectRatioselectNonSélectionnez un rapport d'aspect prédéfini pour le rognage. L'image sera rognée pour correspondre à ce rapport
widthnumberNonDéfinissez la largeur exacte de la zone rognée. Sera limitée à la largeur de l'image si plus grande
heightnumberNonDéfinissez la hauteur exacte de la zone rognée. Sera limitée à la hauteur de l'image si plus grande
gravityselectNonChoose where to position the crop area. Works with all crop modes
xnumberNonDéfinissez la position horizontale de la zone de rognage (0 = bord gauche). Sera ajustée si hors des limites de l'image
ynumberNonDéfinissez la position verticale de la zone de rognage (0 = bord supérieur). Sera ajustée si hors des limites de l'image
formatselectNonChoisissez le format de sortie ou gardez l'original. La conversion en JPEG peut réduire la qualité de transparence
qualitynumberNonQualité de sortie pour les formats avec perte (JPEG, WebP). Plus élevé = meilleure qualité mais fichier plus grand
Les paramètres de type fichier doivent d'abord être uploadés via POST /upload/image-cropper ; 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-cropper": {
      "name": "image-cropper",
      "description": "Recadrez des images à des dimensions spécifiques ou un rapport d'aspect avec un positionnement personnalisé",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-cropper",
      "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-cropper",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "cropMode": "square",
  "aspectRatio": "16:9",
  "width": 0,
  "height": 0,
  "gravity": "center",
  "x": 0,
  "y": 0,
  "format": "original",
  "quality": 90
}
  }
}
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]

Parcourir les outils
Ouvrir l'outil