2 crédits par appel
API de restauration de photos
Réparez des photographies anciennes, abîmées et décolorées depuis votre propre backend. Colorisez et augmentez la résolution en option dans la même requête, au lieu d'enchaîner trois appels.
- REST · JSON
- Sans filigrane
- Rien n'est stocké
POST /v1/image-restoration
Qu'est-ce que l'API de restauration de photos ?
L'API de restauration de photos ImgGen AI est un endpoint REST qui répare les photographies abîmées. Elle atténue rayures, déchirures, taches, décoloration et flou, et peut en option ajouter de la couleur à un original en noir et blanc et augmenter sa résolution dans le même appel. Vous envoyez le scan et l'image restaurée est renvoyée dans la réponse.
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 Image Restoration.
Paramètres de la requête
Envoyez une requête POST vers https://app.imggen.ai/v1/image-restoration, authentifiée avec une clé d'API dans l'en-tête Authorization.
| Paramètre | Type | Obligatoire | Par défaut | Description |
|---|---|---|---|---|
| image | file | OBLIGATOIRE | — | Ajoute une couleur réaliste à une photographie en noir et blanc pendant la restauration. |
| colorize | boolean | facultatif | false | Répare rayures, déchirures et dommages physiques. |
| removeTears | boolean | facultatif | false | Agrandit l'image restaurée pour gagner en résolution. Ajoute le coût de l'agrandisseur à l'appel. |
| enhanceResolution | boolean | facultatif | false | Upscale the restored image for extra resolution. Adds the upscaler cost to the call. |
Comment intégrer l'API de restauration de photos ?
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/image-restoration' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpg \
--form colorize=false \
--form removeTears=true \
--form enhanceResolution=falseimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('colorize', 'false');
form.append('removeTears', 'true');
form.append('enhanceResolution', 'false');
const res = await fetch('https://app.imggen.ai/v1/image-restoration', {
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/image-restoration",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
data={"colorize": "false", "removeTears": "true", "enhanceResolution": "false"},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))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 restored successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}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.
Trois opérations, un appel
Réparer, coloriser et agrandir sont des paramètres de la même requête plutôt que des endpoints distincts : une restauration complète tient en un aller-retour au lieu de trois.
enhanceResolution coûte plus cher
Activer enhanceResolution ajoute le coût de l'agrandisseur au tarif de base de la restauration, car cela exécute aussi le modèle d'agrandissement.
La qualité du scan compte
Le modèle reconstruit à partir de ce qu'il peut voir. Un scan plat, éclairé uniformément et à la plus haute résolution que permet votre scanner donne de bien meilleurs résultats qu'une photo au téléphone d'un tirage.
À quoi sert l'API de restauration de photos ?
Là où les équipes mettent cet endpoint en production pour traiter des images par programmation, à grande échelle.
Plateformes de généalogie et d'archives
Proposez la restauration en un clic des photographies de famille envoyées par vos utilisateurs, sans construire ni héberger de modèle de restauration.
Services de numérisation
Lancez la restauration automatiquement à mesure que les scans sortent du scanner, pour que les opérateurs relisent des résultats plutôt que d'éditer chaque image.
Collections de musées et de bibliothèques
Produisez des copies de consultation présentables de matériel photographique détérioré tout en laissant les originaux intacts.
Produits de tirage photo
Réparez et agrandissez la photographie envoyée par un client en un seul appel avant l'impression.
Combien coûte l'API de restauration de photos ?
Chaque appel réussi coûte 2 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.
| 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.
Endpoints et outils associés
Les équipes qui utilisent l'API de restauration de photos se tournent ensuite généralement vers ceux-ci.
Également disponibles : Suppression d'arrière-plan, Suppression de filigrane, Suppression de texte, Génération d'images.
FAQ sur l'API de restauration de photos
- C'est un endpoint HTTP qui répare automatiquement les photographies abîmées. Il atténue rayures, déchirures, taches, décoloration et flou, et peut en option coloriser et agrandir le résultat. Il existe pour qu'un produit puisse offrir la restauration à ses utilisateurs sans que personne ne fasse de retouche à la main.
- Oui. Mettez colorize=true et le modèle ajoute une couleur réaliste dans la même passe de restauration. Si vous n'avez besoin que de couleur et que la photographie n'est pas abîmée, l'endpoint de colorisation dédié est l'option la moins chère et la plus directe.
- Deux crédits par appel réussi. Mettre enhanceResolution=true ajoute par-dessus le coût de l'agrandisseur, car cela exécute un second modèle. Starter inclut 400 crédits par mois à 9,99 $ et Pro en inclut 1 400 à 29,99 $, les crédits non utilisés étant reportés tant que vous restez abonné.
- Rayures, déchirures, taches, dégâts des eaux, perte de couleur, jaunissement et manque de netteté général. Mettez removeTears=true spécifiquement pour les dommages physiques. Les zones où le contenu d'origine a totalement disparu sont reconstruites de façon plausible, non récupérées — le modèle infère, il ne défait pas.
- Cela peut arriver, et il vaut mieux le comprendre avant de la mettre entre les mains de vos utilisateurs. Le modèle reconstruit l'information manquante par inférence : un visage très abîmé ou en très basse résolution peut revenir subtilement différent de la personne d'origine. Il travaille à partir de ce qui est visible ; là où rien ne l'est, il produit une supposition plausible. Traitez le résultat comme une interprétation restaurée, pas comme un original retrouvé.
- Une photographie par requête. Cet endpoint n'a pas de forme par lot — seule la suppression de filigrane accepte image[]. Pour un fonds entier, lancez les requêtes en parallèle depuis votre propre worker ; chacune est indépendante et facturée séparément.
- L'API accepte les fichiers JPEG (JPG), PNG et WebP jusqu'à 25 Mo par image. Les résultats sont renvoyés sous forme d'image encodée en base64 dans la réponse JSON.
- 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.
- 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.
Commencer
Commencez à appeler l'API de restauration de photos
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