API d'upscaling d'images : Guide d'intégration pour développeurs

Intégrer l'upscaling d'images dans votre app nécessitait avant d'entraîner vos propres modèles IA. Des mois de travail et un gros budget GPU. Avec l'API UpscaleIMG, vous envoyez une image et recevez une version nette et agrandie en quelques secondes.

Ce guide vous montre comment intégrer UpscaleIMG dans votre projet. Avec des exemples de code concrets et toutes les options disponibles.

Que peut faire l'API UpscaleIMG ?

L'API UpscaleIMG utilise Real-ESRGAN. C'est un modèle IA puissant conçu pour la super-résolution d'images. Vous envoyez une photo, et l'IA ajoute des détails réalistes en l'agrandissant. Les contours restent nets. Les textures paraissent naturelles. Les visages gardent leurs traits.

Voici ce que vous obtenez :

• Upscaling 2x et 4x avec amélioration des détails par IA
• Dimensions personnalisées pour une taille de sortie précise
• Conversion de format entre PNG, JPG et WebP
• Contrôle des métadonnées pour supprimer ou garder les données EXIF
• Jusqu'à 64 mégapixels de résolution de sortie

Tout le traitement IA tourne sur nos serveurs. Pas besoin de GPU chez vous. Pas de configuration de modèle. Envoyez une requête HTTP et récupérez votre résultat.

Comment démarrer avec l'API ?

Vous avez besoin d'une clé API pour faire des requêtes. Voici comment l'obtenir :

1. Créez un compte sur upscaleimg.app
2. Allez dans votre tableau de bord et générez une clé API
3. Stockez-la en sécurité sur votre serveur

Le point d'accès de l'API est :

POST https://upscaleimg.app/api/v1/upscale

L'authentification utilise un token Bearer dans le header Authorization. Gardez votre clé API côté serveur. Ne l'exposez jamais dans le code client et ne la committez pas dans votre dépôt.

Les comptes gratuits ont l'upscaling 2x. Les abonnés débloquent le 4x et les dimensions personnalisées jusqu'à 4x la taille originale.

Comment agrandir votre première image ?

L'appel le plus simple ne demande qu'une image et un facteur d'échelle. Voici un exemple curl pour du 2x :

curl -X POST https://upscaleimg.app/api/v1/upscale \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@photo.jpg" \
  -F "scale=2"

L'API renvoie du JSON avec les détails de l'image originale et agrandie :

{
  "original": {
    "size": 384000,
    "width": 1920,
    "height": 1080,
    "mimeType": "image/jpeg",
    "fileExt": "jpg"
  },
  "result": {
    "size": 1280000,
    "width": 3840,
    "height": 2160,
    "mimeType": "image/png",
    "fileExt": "png",
    "url": "https://..."
  }
}

Le champ url vous donne un lien de téléchargement signé. Téléchargez-le tout de suite car les URLs signées expirent rapidement.

La même chose en JavaScript :

const form = new FormData();
form.append('image', fileInput.files[0]);
form.append('scale', '2');

const response = await fetch('https://upscaleimg.app/api/v1/upscale', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: form
});

const data = await response.json();
console.log(`Agrandi à ${data.result.width}x${data.result.height}`);

Et en Python :

import requests

with open('photo.jpg', 'rb') as f:
    response = requests.post(
        'https://upscaleimg.app/api/v1/upscale',
        headers={'Authorization': 'Bearer YOUR_API_KEY'},
        files={'image': f},
        data={'scale': '2'}
    )

data = response.json()
print(f"Agrandi à {data['result']['width']}x{data['result']['height']}")

Quelles options l'API supporte-t-elle ?

L'API accepte plusieurs paramètres via des données multipart. Voici la liste complète :

Paramètre	Obligatoire	Valeurs	Description
image	Oui	Fichier	Image PNG, JPG, JPEG ou WebP
scale	Oui*	2 ou 4	Facteur d'échelle. *Pas nécessaire avec des dimensions personnalisées.
customWidth	Non	Entier	Largeur cible en pixels (max. 4x l'original)
customHeight	Non	Entier	Hauteur cible en pixels (max. 4x l'original)
objectFit	Non	cover, contain, fill	Mode d'ajustement avec dimensions personnalisées. Par défaut : cover.
outputFormat	Non	jpg, jpeg, png, webp	Format de sortie. Par défaut : png.
removeMetadata	Non	1 ou 0	Supprimer les données EXIF. Par défaut : 0 (garder).

Les dimensions personnalisées vous donnent un contrôle précis. customWidth et customHeight doivent être indiqués ensemble. La sortie ne peut pas être plus petite que l'original ni plus grande que 4x (2x pour les comptes gratuits).

Par exemple, pour agrandir à exactement 3000x2000 en WebP :

curl -X POST https://upscaleimg.app/api/v1/upscale \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@photo.jpg" \
  -F "customWidth=3000" \
  -F "customHeight=2000" \
  -F "objectFit=cover" \
  -F "outputFormat=webp" \
  -F "removeMetadata=1"

Le paramètre objectFit fonctionne comme CSS object-fit. cover remplit les dimensions exactes (peut recadrer). contain s'adapte dans les dimensions (peut ajouter des marges). fill étire à la taille exacte.

Comment gérer les erreurs et les limites de requêtes ?

L'API renvoie des codes HTTP standards :

Code	Signification
200	Succès. Image agrandie renvoyée.
400	Requête invalide. Image manquante, facteur invalide ou dimensions hors limites.
401	Clé API invalide ou manquante.
403	Interdit. Tentative de 4x sans abonnement ou erreur CORS.
429	Limite atteinte. Trop de requêtes.
500	Erreur serveur. Réessayez.

Toutes les réponses d'erreur incluent un message :

{"error": "4x upscaling is only available with an active subscription."}

Pour les limites de requêtes, ajoutez une logique de réessai avec backoff :

async function upscaleWithRetry(form, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const res = await fetch('https://upscaleimg.app/api/v1/upscale', {
      method: 'POST',
      headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
      body: form
    });

    if (res.status === 429) {
      await new Promise(r => setTimeout(r, 2000 * (i + 1)));
      continue;
    }

    return await res.json();
  }
  throw new Error('Max retries reached');
}

Quels sont les meilleurs cas d'utilisation ?

L'API UpscaleIMG s'intègre naturellement dans plusieurs workflows.

Les plateformes e-commerce l'utilisent pour améliorer les photos de produits des vendeurs. Beaucoup de photos sont petites ou de mauvaise qualité. L'upscaling automatique rend chaque annonce plus professionnelle. En savoir plus sur agrandir des images sans perte de qualité.

Les services d'impression à la demande ont besoin de fichiers haute résolution. Les clients téléchargent souvent des images trop petites pour l'impression. Vous pouvez même agrandir directement en 4K.

Les apps de restauration photo combinent l'upscaling avec d'autres améliorations. Les photos anciennes ou floues sont rendues nettes et agrandies. L'API fait le gros du travail IA.

Les systèmes de gestion de contenu peuvent améliorer les images automatiquement au téléchargement. Chaque image reste au-dessus d'un seuil de qualité minimum.

Les sites immobiliers profitent d'une qualité photo uniforme. Les agents téléchargent avec différents appareils. L'upscaling automatique crée une apparence professionnelle.

Pour le traitement par lots, consultez notre guide sur l'automatisation de l'upscaling d'images. Vous pouvez aussi comparer les meilleurs upscalers.

Prêt à commencer ?

Vous aurez une intégration fonctionnelle en moins d'une heure. Créez votre compte sur upscaleimg.app, récupérez votre clé API et envoyez votre première image test.

Commencez par du 2x sur quelques images pour vérifier la qualité. Puis intégrez dans votre pipeline. Le guide complet de l'agrandissement d'images couvre tout ce qu'il faut savoir sur l'upscaling IA.

Le plan gratuit suffit pour tester et construire votre proof of concept. Quand vous êtes prêt pour le 4x et de plus gros volumes, passez à un plan payant.