Compresser une image API

Compresser une image API, ImageMini connecte la tâche à votre propre application : vous envoyez le fichier, interrogez l'état de la tâche et téléchargez le résultat. Les points de terminaison fonctionnent côté serveur, sans intervention du navigateur.

Démarrage rapide

Créez une clé dans la section API Développeur de votre compte ; la clé en texte brut n'est affichée qu'au moment de sa création.
Envoyez la requête à https://api.pixepi.com avec l'en-tête Authorization: Bearer <key>.
Interrogez la tâche dans la réponse avec GET https://api.pixepi.com/api/v1/jobs/{id} ; dès que le statut passe à done, téléchargez le résultat depuis download_url.

Exemple de requête

curl -X POST "https://api.pixepi.com/api/v1/apps/gorsel-kucult/run" \
  -H "Authorization: Bearer $PIXEPI_KEY" \
  -F "[email protected]" \
  -F "options[quality]=82" \
  -F "options[format]=same"

curl -H "Authorization: Bearer $PIXEPI_KEY" "https://api.pixepi.com/api/v1/jobs/42"

Points de terminaison de cet outil

Méthode	Chemin	Description
`POST`	`/run`	Exécute l'outil, lance une tâche et renvoie le résultat.

Options

Les options sont transmises sous la forme options[<field>] ; un champ laissé vide applique sa valeur par défaut.

Champ	Valeurs	Par défaut
`options[quality]` Qualité	40–95	`82`
`options[max_side]` Limite du grand côté (facultatif)	0–6000	`vide`
`options[format]` Format de sortie	same · jpeg · webp · png	`same`
`options[auto_rotate]` Corriger l'orientation du smartphone	activé · désactivé	`activé`

Points de terminaison partagés

Méthode	Chemin	Description
`GET`	`/api/v1/apps`	Catalogue d'API
`GET`	`/api/v1/apps/gorsel-kucult`	Spécification de l'outil
`GET`	`/api/v1/jobs/{id}`	Statut de la tâche
`GET`	`/api/v1/jobs/{id}/download`	Télécharger le résultat de la tâche
`GET`	`/api/v1/usage`	Résumé d'utilisation
`GET`	`/api/v1/openapi.json`	Document OpenAPI 3.1

Limites

Au maximum 100 MB par fichier.
Traitement par lot : envoyez le même champ file plusieurs fois.
Les quotas et les informations d'abonnement sont rattachés à votre compte ; vérifiez l'état actuel avec GET /api/v1/usage.

Codes d'erreur

Code	Signification
`unauthorized`	La clé d'API est manquante ou invalide.
`forbidden`	Cette opération n'est pas autorisée avec cette clé.
`not_found`	Outil, tâche ou enregistrement introuvable (404 également pour accès inter-comptes).
`invalid_input`	Échec de validation des données saisies (champ manquant ou mal formé, date invalide, etc.).
`invalid_request`	La requête est mal formée.
`too_large`	La taille du fichier ou du corps dépasse la limite autorisée.
`unsupported_media`	Ce type de fichier n'est pas accepté.
`not_supported`	Cet outil ne peut pas fonctionner sur ce point de terminaison (application avec état).
`not_ready`	La tâche n'est pas encore terminée.
`expired`	Le fichier généré a expiré.
`no_output`	Aucun fichier à télécharger pour cette tâche.
`invalid_path`	Chemin de sortie invalide.
`quota_exceeded`	Quota ou limite de requêtes dépassé.
`rate_limited`	Trop de requêtes en peu de temps ; veuillez patienter avant de réessayer.
`csrf`	Échec de la vérification du formulaire de navigation (l'API externe utilise des clés).
`conflict`	L'opération entre en conflit avec l'état actuel.
`unavailable`	L'outil est temporairement indisponible.
`internal_error`	Erreur interne du serveur inattendue.

Documents

Foire aux questions

Comment obtenir une clé API ?

Créez une clé dans la section API Développeur de votre compte ; la clé n'est affichée qu'une seule fois, au moment de sa création.

Comment envoyer une requête ?

Les points de terminaison fonctionnent sur https://api.pixepi.com ; chaque requête doit inclure l'en-tête "Authorization: Bearer <clé>".

Quels fichiers l'API ImageMini accepte-t-elle ?

Types acceptés : JPG · JPEG · PNG · WEBP. La limite est de 100 MB par fichier ; les options sont identiques à celles de la page de l'outil.

Comment interpréter une réponse d'erreur ?

Le corps de l'erreur contient les champs {ok:false, error, code, request_id} ; les valeurs des codes figurent dans le tableau des codes d'erreur.