Design

Transformation Affine d'Image

Appliquer une transformation affine pour la mise à l'échelle, rotation, cisaillement et translation

file· Résultat fichierOuvrir l'outil

Démarrage rapide

Appelez cet outil depuis votre code en trois langages.

cURL

# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/image-affine' \
  -F 'file=@/path/to/imageFile.ext'

# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/fr/api/tools/image-affine' \
  -F 'imageFile=/path/to/file.ext' \
  -F 'scaleX=1.0' \
  -F 'scaleY=1.0' \
  -F 'angle=0' \
  -F 'shearX=0' \
  -F 'shearY=0' \
  -F 'translateX=0' \
  -F 'translateY=0' \
  -F 'background=transparent' \
  -F 'format=original' \
  -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-affine

Paramètres

Nom	Type	Requis	Description
imageFile	fileupload requis	Oui	Téléchargez tout fichier image (JPEG, PNG, WebP, GIF, BMP, TIFF) pour transformation affine
scaleX	range	Non	Facteur d'échelle horizontal(0.1 à 10.0, 1.0 = taille originale)
scaleY	range	Non	Facteur d'échelle vertical(0.1 à 10.0, 1.0 = taille originale)
angle	range	Non	Angle de rotation en degrés (-180 à 180, 0 = pas de rotation)
shearX	range	Non	Facteur de cisaillement horizontal (-2.0 à 2.0, 0 = pas de cisaillement)
shearY	range	Non	Facteur de cisaillement vertical (-2.0 à 2.0, 0 = pas de cisaillement)
translateX	range	Non	Translation horizontale en pixels (-1000 à 1000, 0 = pas de translation)
translateY	range	Non	Translation verticale en pixels (-1000 à 1000, 0 = pas de translation)
background	text	Non	Couleur de fond pour zones transparentes (hex #RRGGBB ou #RRGGBBAA, ou nom de couleur)
format	select	Non	Choisissez le format de sortie ou gardez l'original.PNG recommandé pour la transparence
quality	number	Non	Qualité de sortie pour les formats avec perte (JPEG, WebP). Plus élevé = meilleure qualité mais fichier plus volumineux

Les paramètres de type fichier doivent d'abord être uploadés via POST /upload/image-affine ; 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-affine": {
      "name": "image-affine",
      "description": "Appliquer une transformation affine pour la mise à l'échelle, rotation, cisaillement et translation",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-affine",
      "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-affine",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "scaleX": "1.0",
  "scaleY": "1.0",
  "angle": "0",
  "shearX": "0",
  "shearY": "0",
  "translateX": "0",
  "translateY": "0",
  "background": "transparent",
  "format": "original",
  "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]