Morphix API

Intégrez la conversion, le redimensionnement, le recadrage et la suppression de métadonnées dans vos applications via notre API REST.

Authentification

Toutes les requêtes API nécessitent une clé API envoyée via le header Authorization.

curl -X POST https://morphix.tools/api/v1/convert \
  -H "Authorization: Bearer mk_live_your_api_key_here" \
  -F "file=@photo.jpg" \
  -F "format=webp" \
  -F "quality=80"

Créez une clé API depuis votre page de compte

Base URL

https://morphix.tools/api/v1

Endpoints

POST `/api/v1/convert`

Convertir une image dans un autre format.

Paramètre	Type	Requis	Description
file	file	Oui	Fichier image (JPG, PNG, WebP, AVIF)
format	string	Oui	webp, avif, jpg, png
quality	int	Non	1-100 (Défaut: 80)

POST `/api/v1/crop`

Recadrer une zone rectangulaire d'une image.

Paramètre	Type	Requis	Description
file	file	Oui	Fichier image (JPG, PNG, WebP, AVIF)
x	int	Oui	Décalage gauche en pixels
y	int	Oui	Décalage haut en pixels
width	int	Oui	Largeur du recadrage en pixels
height	int	Oui	Hauteur du recadrage en pixels

POST `/api/v1/resize`

Redimensionner une image aux dimensions souhaitées.

Paramètre	Type	Requis	Description
file	file	Oui	Fichier image (JPG, PNG, WebP, AVIF)
width	int	Non*	1-12000 px
height	int	Non*	1-12000 px
keep_aspect_ratio	bool	Non	Défaut: true

* Au moins une dimension (largeur ou hauteur) est requise.

POST `/api/v1/remove-metadata`

Supprimer les métadonnées EXIF, ICC et autres d'une image.

Paramètre	Type	Requis	Description
file	file	Oui	Fichier image (JPG, PNG, WebP, AVIF)

Format de réponse

Les réponses réussies retournent un objet JSON avec une URL de téléchargement :

{
  "success": true,
  "data": {
    "uuid": "a1b2c3d4e5f6...",
    "format": "webp",
    "filename": "photo.webp",
    "size": 45230,
    "download_url": "https://morphix.tools/download/a1b2c3.../webp/photo.webp"
  }
}

Les réponses d'erreur incluent un code lisible par machine :

{
  "success": false,
  "error": {
    "code": "DAILY_LIMIT_REACHED",
    "message": "Daily limit reached. 0 conversion(s) remaining today."
  }
}

Codes d'erreur

Code	HTTP	Description
INVALID_PARAMETERS	422	Paramètres de requête manquants ou invalides.
UNSUPPORTED_FORMAT	422	Le format du fichier n'est pas supporté.
FILE_TOO_LARGE	422	Le fichier dépasse la limite de taille.
DAILY_LIMIT_REACHED	429	Quota journalier épuisé (offre Free).
RATE_LIMIT_EXCEEDED	429	Trop de requêtes par seconde (offre Pro).
CONVERSION_FAILED	500	Le traitement de l'image a échoué.

Limites

Offre	Limite journalière	Limite par seconde	Taille max
Free	10 conversions/jour	-	10 MB
Pro	Illimité	10 req/s	10 MB

Les quotas journaliers sont partagés entre l'utilisation web et API.

Commencer

Créez votre clé API et intégrez Morphix dans votre workflow.

Créer une clé API