Design

Ajustement de Niveaux d'Image

Ajustez les niveaux de l'image avec contrôle précis sur les ombres, tons moyens et hautes lumières pour correction tonale professionnelle

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-levels' \
  -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-levels' \
  -F 'imageFile=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -F 'shadowInput=0' \
  -F 'shadowOutput=0' \
  -F 'midtoneInput=0.5' \
  -F 'midtoneOutput=0.5' \
  -F 'highlightInput=1' \
  -F 'highlightOutput=1' \
  -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-levels

Paramètres

Nom	Type	Requis	Description
imageFile	fileupload requis	Oui	Téléchargez tout fichier image (JPEG, PNG, WebP, GIF, BMP, TIFF) pour ajuster les niveaux
shadowInput	number	Non	Shadow input level (0 = pure black, 1 = white). Maps input shadow levels to new values
shadowOutput	number	Non	Shadow output level (0 = pure black, 1 = white). Sets the output for shadow areas
midtoneInput	number	Non	Midtone input level (0 = pure black, 0.5 = middle gray, 1 = white). Controls tonal balance
midtoneOutput	number	Non	Midtone output level (0 = pure black, 0.5 = middle gray, 1 = white). Adjusts overall brightness
highlightInput	number	Non	Highlight input level (0 = pure black, 1 = white). Maps input highlight levels to new values
highlightOutput	number	Non	Highlight output level (0 = pure black, 1 = white). Sets the output for highlight areas
format	select	Non	Choose output format or keep original. PNG recommended for maximum quality
quality	number	Non	Output quality for lossy formats (JPEG, WebP). Higher = better quality but larger file size

Les paramètres de type fichier doivent d'abord être uploadés via POST /upload/image-levels ; 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-levels": {
      "name": "image-levels",
      "description": "Ajustez les niveaux de l'image avec contrôle précis sur les ombres, tons moyens et hautes lumières pour correction tonale professionnelle",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-levels",
      "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-levels",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "shadowInput": 0,
  "shadowOutput": 0,
  "midtoneInput": 0.5,
  "midtoneOutput": 0.5,
  "highlightInput": 1,
  "highlightOutput": 1,
  "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]