Qu'est-ce qu'une API d'agrandissement d'images et comment fonctionne-t-elle ?

C'est un endpoint HTTP qui augmente la résolution d'une image à l'aide d'un modèle entraîné. Au lieu d'interpoler entre les pixels existants comme le fait un redimensionnement, le modèle prédit le détail que contiendrait une version en plus haute résolution de cette image — contours, texture et structure — puis le reconstruit. Vous envoyez l'image en POST et lisez le résultat agrandi dans la réponse.

Quels facteurs d'agrandissement et quels types d'image sont pris en charge ?

Le paramètre factor accepte 2 ou 4 et vaut 4 par défaut. L'entrée peut être JPEG (JPG), PNG et WebP jusqu'à 25 Mo, et la sortie peut être renvoyée en jpeg (par défaut) ou png.

Comment fonctionne la tarification de l'API d'agrandissement ?

Le coût suit le facteur : 2 crédits avec factor=2 et 4 crédits avec factor=4 (la valeur par défaut). Starter donne 400 crédits par mois pour 9,99 $ et Pro en donne 1 400 pour 29,99 $, les crédits non utilisés étant reportés tant que vous restez abonné. Une tarification en crédits signifie qu'un mois chargé et un mois calme vous coûtent la même chose par image.

L'API peut-elle aussi améliorer la qualité, retirer le flou ou restaurer de vieilles photos ?

L'agrandissement reconstruit du détail en agrandissant, ce qui accentue au passage les images floues, et le paramètre sharpen pousse cet effet plus loin. Pour des photographies abîmées ou décolorées — rayures, déchirures, perte de couleur — utilisez plutôt l'API de restauration de photos, conçue pour réparer et non pour augmenter la résolution.

L'agrandissement est-il synchrone ou asynchrone ?

Synchrone. Aucun identifiant de job à interroger, aucun webhook à configurer : l'image agrandie se trouve dans le corps de la même réponse, avec un plafond de 60 secondes par requête.

Puis-je utiliser commercialement les images agrandies ?

Oui. Tous les forfaits, y compris le forfait gratuit, incluent des droits d'usage commercial complets, et aucun résultat ne porte de filigrane. Vous pouvez vendre, imprimer ou publier tout ce que l'API renvoie.

Stockez-vous les images que j'agrandis ?

Non. L'API est sans état : elle ne crée aucun projet, n'enregistre aucun fichier et ne conserve pas votre image. Votre envoi est écrit dans un objet temporaire, traité, puis supprimé dès que la réponse est renvoyée. La seule chose conservée est un journal d'utilisation indiquant qu'un appel a eu lieu et combien de crédits il a coûté. Vos images ne servent jamais à entraîner des modèles.

2–4 crédits par appel

API d'agrandissement d'images

Augmentez la résolution de vos images en 2x ou 4x depuis votre propre backend. Amélioration des visages et netteté en option, sortie JPEG ou PNG, et un tarif qui suit le facteur demandé.

REST · JSON
Sans filigrane
Rien n'est stocké

Obtenir votre clé d'API Lire la documentation

endpoint

POST /v1/upscale-image

URL de base: https://app.imggen.ai
Auth: Authorization: Bearer sk_live_…
Coût: 2–4 crédits
Entrée: JPEG (JPG), PNG and WebP · max 25 MB

01 — Aperçu

Qu'est-ce que l'API d'agrandissement d'images ?

L'API d'agrandissement d'images ImgGen AI est un endpoint REST qui augmente la résolution d'une image par IA plutôt que par simple interpolation. Elle reconstruit les contours, les textures et le détail fin au lieu d'étirer les pixels : le résultat reste net. Vous envoyez une image et un facteur d'échelle, et le résultat en plus haute résolution revient dans la même requête.

C'est l'un des sept endpoints de l'API d'édition d'images ImgGen AI, qui partagent tous une seule clé d'API, une seule URL de base et le même format de requête et de réponse. Si vous avez aussi besoin de cette fonction dans un navigateur plutôt que depuis du code, le même modèle d'IA anime l'outil AI Image Upscaler.

02 — Requête

Paramètres de la requête

Envoyez une requête POST vers https://app.imggen.ai/v1/upscale-image, authentifiée avec une clé d'API dans l'en-tête Authorization.

Paramètres acceptés par cet endpoint
Paramètre	Type	Obligatoire	Par défaut	Description
image	file	OBLIGATOIRE	—	Facteur d'agrandissement. Accepte 2 ou 4.
factor	number	facultatif	4	Applique une reconstruction faciale supplémentaire. Utile pour les portraits et les photos de groupe.
enhanceFace	boolean	facultatif	false	Applique une netteté supplémentaire au résultat agrandi.
sharpen	boolean	facultatif	false	Format de sortie. Accepte jpeg ou png.
output	string	facultatif	jpeg	Output format. Accepts jpeg or png.

03 — Intégration

Comment intégrer l'API d'agrandissement d'images ?

Créez une clé d'API dans votre compte ImgGen, enregistrez-la comme variable d'environnement et appelez l'endpoint. Voici la même requête en cURL, Node.js et Python.

curl --request POST \
  --url 'https://app.imggen.ai/v1/upscale-image' \
  --header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
  --form image=@/path/to/photo.jpg \
  --form factor=4 \
  --form enhanceFace=false \
  --form sharpen=false \
  --form output=jpeg

import fs from 'node:fs';

const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('factor', '4');
form.append('enhanceFace', 'false');
form.append('sharpen', 'false');
form.append('output', 'jpeg');

const res = await fetch('https://app.imggen.ai/v1/upscale-image', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
  body: form,
});

const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));

import base64, os, requests

with open("photo.jpg", "rb") as f:
    res = requests.post(
        "https://app.imggen.ai/v1/upscale-image",
        headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
        files={"image": f},
    data={"factor": "4", "enhanceFace": "false", "sharpen": "false", "output": "jpeg"},
    )

data = res.json()
with open("result.png", "wb") as out:
    out.write(base64.b64decode(data["image"]))

04 — Réponse

Réponse

Un appel réussi renvoie du JSON. Le résultat est encodé en base64 — décodez-le avant de l'écrire sur disque ou dans votre stockage objet. Chaque réponse réussie porte aussi un en-tête X-Credit-Remaining avec votre solde après l'appel.

{
  "success": true,
  "message": "Image upscaled successfully",
  "image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}

05 — Limites

Limites et comportements à connaître

L'endpoint accepte JPEG (JPG), PNG et WebP avec une taille de fichier maximale de 25 Mo, et répond de façon synchrone en moins de 60 secondes : aucun job à interroger, aucun webhook à configurer.

Choisissez votre format de sortie

Utilisez output=png quand vous avez besoin d'un résultat sans perte ou de conserver un canal alpha ; jpeg garde les réponses légères pour les gros volumes de catalogue.

L'amélioration des visages est optionnelle

enhanceFace applique une reconstruction faciale supplémentaire pour améliorer et agrandir les portraits. Laissez-la désactivée pour les photos produit et les paysages, où il n'y a aucun visage à améliorer.

Synchronous by design

There is no job queue to poll. The upscaled image comes back in the same response, within the 60-second request ceiling.

06 — En production

À quoi sert l'API d'agrandissement d'images ?

Là où les équipes mettent cet endpoint en production pour traiter des images par programmation, à grande échelle.

Migration d'anciens catalogues

Amenez des années d'images produit petites et en basse résolution aux standards actuels de haute résolution dans un traitement par lot, plutôt que de les rephotographier.

Préparation à l'impression

Faites passer des visuels prévus pour le web à une taille de qualité qui tient à l'impression, avec une netteté optionnelle appliquée dans le même appel pour un rendu plus précis.

Contenu généré par les utilisateurs

Agrandissez avatars et petits envois côté serveur pour qu'ils s'affichent proprement sur les écrans haute densité.

Médias et archives

Augmentez la résolution d'images numérisées ou compressées avant leur entrée dans un gestionnaire de contenu, avec la restauration lorsque c'est nécessaire.

07 — Coût

Combien coûte l'API d'agrandissement d'images ?

Chaque appel réussi coûte 2–4 crédits : votre coût réel par image dépend donc du forfait que vous avez. Les crédits proviennent de votre forfait et sont partagés entre tous les endpoints et l'éditeur web, vous n'achetez donc pas un quota séparé par outil. Un appel qui échoue est remboursé automatiquement. Voir tous les détails sur la page tarifs.

Forfaits ImgGen AI et accès à l'API
Forfait	Prix	Crédits	API
Free	$0	50 crédits gratuits en une fois	Pas d'accès à l'API
Starter	$9.99 / month	400 crédits / mois	Accès à l'API inclus
Pro	$29.99 / month	1 400 crédits / mois	Accès à l'API + support prioritaire
Enterprise	Custom	Volume sur mesure	Infrastructure dédiée

Coûts en crédits et limites vérifiés pour la dernière fois le 2026-08-27.

08 — Associés

Les équipes qui utilisent l'API d'agrandissement d'images se tournent ensuite généralement vers ceux-ci.

→API de restauration de photos →API de colorisation de photos AI Image Upscaler (outil web)Tous les endpoints de l'API

Également disponibles : Suppression d'arrière-plan, Suppression de filigrane, Suppression de texte, Génération d'images.

FAQ

FAQ sur l'API d'agrandissement d'images

: C'est un endpoint HTTP qui augmente la résolution d'une image à l'aide d'un modèle entraîné. Au lieu d'interpoler entre les pixels existants comme le fait un redimensionnement, le modèle prédit le détail que contiendrait une version en plus haute résolution de cette image — contours, texture et structure — puis le reconstruit. Vous envoyez l'image en POST et lisez le résultat agrandi dans la réponse.
: Le paramètre factor accepte 2 ou 4 et vaut 4 par défaut. L'entrée peut être JPEG (JPG), PNG et WebP jusqu'à 25 Mo, et la sortie peut être renvoyée en jpeg (par défaut) ou png.
: Le coût suit le facteur : 2 crédits avec factor=2 et 4 crédits avec factor=4 (la valeur par défaut). Starter donne 400 crédits par mois pour 9,99 $ et Pro en donne 1 400 pour 29,99 $, les crédits non utilisés étant reportés tant que vous restez abonné. Une tarification en crédits signifie qu'un mois chargé et un mois calme vous coûtent la même chose par image.
: L'agrandissement reconstruit du détail en agrandissant, ce qui accentue au passage les images floues, et le paramètre sharpen pousse cet effet plus loin. Pour des photographies abîmées ou décolorées — rayures, déchirures, perte de couleur — utilisez plutôt l'API de restauration de photos, conçue pour réparer et non pour augmenter la résolution.
: Synchrone. Aucun identifiant de job à interroger, aucun webhook à configurer : l'image agrandie se trouve dans le corps de la même réponse, avec un plafond de 60 secondes par requête.
: Oui. Tous les forfaits, y compris le forfait gratuit, incluent des droits d'usage commercial complets, et aucun résultat ne porte de filigrane. Vous pouvez vendre, imprimer ou publier tout ce que l'API renvoie.
: Non. L'API est sans état : elle ne crée aucun projet, n'enregistre aucun fichier et ne conserve pas votre image. Votre envoi est écrit dans un objet temporaire, traité, puis supprimé dès que la réponse est renvoyée. La seule chose conservée est un journal d'utilisation indiquant qu'un appel a eu lieu et combien de crédits il a coûté. Vos images ne servent jamais à entraîner des modèles.

Commencer

Commencez à appeler l'API d'agrandissement d'images

Une seule clé débloque les sept endpoints. Sans filigrane, avec des droits commerciaux complets, et rien de ce que vous envoyez n'est conservé une fois la réponse renvoyée.

Obtenir votre clé d'API