v1 · 7 endpoints · en ligne
Édition d'images
API pour développeurs
Sept endpoints de traitement d'images par IA derrière une seule clé d'API : suppression d'arrière-plan, agrandissement, suppression de filigrane et de texte, restauration, colorisation et texte vers image. Du REST simple, une réponse JSON, et rien de stocké une fois l'appel terminé.
- 7 endpoints, 1 clé
- REST sur HTTPS
- Sans filigrane
- Rien n'est stocké
$ curl -X POST app.imggen.ai/v1/remove-background \
-H "Authorization: Bearer sk_live_..." \
-F image=@photo.jpg
→ 200 OK · 128 ms · X-Credit-Remaining: 385
{
"success": true,
"image": "iVBORw0KGgoAAAANSUhEUg..."
}Qu'est-ce que l'API d'édition d'images ImgGen AI ?
L'API d'édition d'images ImgGen AI est un service REST qui effectue du traitement d'images par IA à la demande. Vous envoyez une image — ou un prompt de texte — à un endpoint via HTTPS, et le résultat traité revient encodé en base64 dans la réponse JSON. Aucun modèle à héberger, aucun GPU à provisionner.
Tous les endpoints partagent la même URL de base, la même clé d'API et le même format de réponse : ajouter une seconde capacité à votre flux revient à changer de chemin, pas à monter une nouvelle intégration. Si vous voulez tester les modèles avant d'écrire du code, ce sont les mêmes qui animent les outils gratuits ImgGen AI dans le navigateur.
Comment utiliser l'API d'édition d'images ?
Générez une clé d'API, puis envoyez une requête multipart avec votre image. Cet exemple supprime un arrière-plan ; tous les autres endpoints d'édition suivent le même schéma avec un chemin différent. La génération d'images fait exception : elle reçoit un corps JSON avec votre prompt, le nombre d'échantillons et le format plutôt qu'un fichier.
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-background' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpgimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
const res = await fetch('https://app.imggen.ai/v1/remove-background', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const { image } = await res.json();
fs.writeFileSync('result.png', Buffer.from(image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/remove-background",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
with open("result.png", "wb") as out:
out.write(base64.b64decode(res.json()["image"]))Les sept endpoints
Chacun dispose de sa propre page de référence avec les paramètres, des exemples de code dans trois langages et son coût exact en crédits.
API de suppression d'arrière-plan
Supprimez l'arrière-plan de vos images par code avec une seule requête POST. Une clé d'API, une sortie en PNG transparent et un service sans état qui ne conserve jamais les images que vous envoyez.
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é.
API de suppression de filigrane
Détectez et effacez les filigranes de vos images en une seule requête. L'inpainting génératif reconstruit les pixels situés derrière la marque, et c'est le seul endpoint qui accepte aussi un lot d'images.
API de suppression de texte
Effacez légendes, incrustations, horodatages et étiquettes intégrées de vos images par code. La détection est automatique — et s'il n'y a pas de texte dans l'image, vous n'êtes pas facturé.
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.
API de colorisation de photos
Transformez des photographies en noir et blanc en images aux couleurs naturelles avec une seule requête. Réparation des déchirures en option dans le même appel, et aucun choix de couleur manuel à aucun moment.
API de génération d'images par IA
Générez des images à partir d'un prompt de texte avec une seule requête JSON. Jusqu'à quatre échantillons par appel, trois modèles pour arbitrer entre vitesse et qualité, et des droits commerciaux complets sur le résultat.
Combien coûte l'API d'édition d'images ?
L'usage repose sur des crédits plutôt que sur un tarif fixe par appel : un mois chargé et un mois calme coûtent la même chose par image. Les crédits sont partagés entre tous les endpoints et l'éditeur web — un seul solde, pas un quota séparé par outil. Un appel qui échoue est remboursé automatiquement, et chaque réponse réussie renvoie votre solde restant dans l'en-tête X-Credit-Remaining.
| Endpoint | Chemin | Crédits / appel |
|---|---|---|
| Suppression d'arrière-plan | /v1/remove-background | 1 |
| Agrandissement d'images | /v1/upscale-image | 2–4 |
| Suppression de filigrane | /v1/remove-watermark | 2 |
| Suppression de texte | /v1/remove-text | 2 |
| Restauration de photos | /v1/image-restoration | 2 |
| Colorisation de photos | /v1/colorize-photo | 2 |
| Génération d'images | /v1/generate-image | 3+ |
| Forfait | Prix | Crédits | API | Remarques |
|---|---|---|---|---|
| Free | $0 | 50 crédits gratuits en une fois | Pas d'accès à l'API | Sans carte bancaire |
| Starter | $9.99 / month | 400 crédits / mois | Accès à l'API inclus | Les crédits non utilisés sont reportés |
| Pro | $29.99 / month | 1 400 crédits / mois | Accès à l'API + support prioritaire | Les crédits non utilisés sont reportés |
| Enterprise | Custom | Volume sur mesure | Infrastructure dédiée | support@imggen.ai |
Coûts en crédits et limites vérifiés pour la dernière fois le 2026-08-27. Tous les détails sur la page tarifs.
Comment fonctionne l'API
Volontairement banal : une requête, une réponse, aucune orchestration de votre côté.
Synchrone, sans file d'attente
L'image traitée se trouve dans le corps de la même réponse. Aucun identifiant de job à interroger, aucun endpoint de webhook à monter, aucune file à réconcilier. Les requêtes sont soumises à un plafond de 60 secondes.
Multipart en entrée, base64 en sortie
Envoyez votre image d'entrée sous forme de formulaire multipart — JPEG (JPG), PNG et WebP, jusqu'à 25 Mo. Le résultat revient encodé en base64 dans le corps JSON : décodez-le et écrivez-le là où vous stockez vos fichiers.
Facturé uniquement en cas de succès
Les crédits sont débités de façon atomique et remboursés automatiquement si le traitement échoue : vous n'êtes facturé que pour les images qui reviennent réellement. La suppression de texte renvoie même un 422 sans frais lorsqu'il n'y a aucun texte à retirer.
Des clés que vous pouvez faire tourner
Les clés ne sont affichées qu'une fois et ne sont stockées que sous forme de hash. La révocation se propage en une minute environ : une clé fuitée est un problème d'une minute, pas un incident.
L'API stocke-t-elle mes images ou s'entraîne-t-elle dessus ?
Non. L'API est sans état. Contrairement à l'éditeur web, qui enregistre vos projets pour que vous puissiez y revenir, un appel d'API ne crée aucun projet, aucun enregistrement de tâche et aucun fichier stocké. 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. C'est important si vous traitez des photos de clients que vous n'avez pas contractuellement le droit de conserver : c'est l'architecture, et pas seulement la politique, qui les tient hors de notre stockage.
Réponses d'erreur
Les échecs renvoient une enveloppe JSON de la forme { "error": { "message", "code" } }, le statut HTTP correspondant au code.
| Statut | Code | Signification |
|---|---|---|
| 401 | UNAUTHORIZED | La clé d'API est absente, mal formée ou a été révoquée. |
| 402 | INSUFFICIENT_CREDITS | Votre compte n'a pas assez de crédits pour cet appel. |
| 403 | FORBIDDEN | Votre forfait ne donne pas accès à cet outil. |
| 404 | NOT_FOUND | Le chemin de l'endpoint n'existe pas. |
| 409 | CONFLICT | La requête entre en conflit avec l'état actuel de la ressource. |
| 422 | VALIDATION_ERROR | La requête a été rejetée : type de fichier invalide, champ manquant ou rien à traiter. Aucun crédit n'est facturé. |
Qui utilise l'API ImgGen ?
Là où une API de traitement d'images gagne sa place dans un produit.
E-commerce et places de marché
Normalisez les images de vos fournisseurs et vendeurs dès l'envoi : détourez les fonds, retirez les textes incrustés et agrandissez les vieilles photos en basse résolution pour que chaque annonce semble sortir du même studio.
Print-on-demand et mockups produit
Isolez le visuel, montez en résolution jusqu'au standard d'impression et composez sur des gabarits sans qu'un designer touche à chaque commande.
SaaS de design et d'édition
Livrez des fonctions d'édition en un clic dans votre propre produit sans héberger de GPU, affiner de modèles ni maintenir une infrastructure d'inférence.
Archives, généalogie et numérisation
Réparez, colorisez et agrandissez des photographies numérisées dans un pipeline automatisé au lieu de retoucher chaque image à la main.
Plateformes de contenu et d'édition
Générez des visuels originaux à partir d'un prompt et nettoyez les envois de vos contributeurs dans votre flux éditorial existant.
Agences et outils internes
Automatisez le travail répétitif sur les images qui se situe entre le brief client et le livrable final, depuis les outils que votre équipe utilise déjà.
FAQ sur l'API d'édition d'images
- Oui. L'API d'édition d'images ImgGen AI expose sept endpoints REST — suppression d'arrière-plan, agrandissement d'images, suppression de filigrane, suppression de texte, restauration de photos, colorisation et génération d'images à partir de texte — tous sur https://app.imggen.ai et accessibles avec une seule clé d'API.
- Elle applique une modification précise à l'image que vous envoyez et renvoie le résultat dans la même réponse. Vous pouvez supprimer un arrière-plan pour obtenir un PNG transparent, agrandir en 2x ou 4x, effacer des filigranes ou du texte incrusté, réparer et coloriser des photographies abîmées, et générer de nouvelles images à partir d'un prompt.
- Créez un compte ImgGen sur https://editor.imggen.ai et générez une clé depuis les paramètres de votre compte. La clé n'est affichée qu'une fois et n'est stockée que sous forme de hash : copiez-la en lieu sûr, car si elle est perdue vous en générez une nouvelle plutôt que de récupérer l'ancienne. La révocation d'une clé prend effet en une minute environ.
- Envoyez votre clé comme bearer token : Authorization: Bearer sk_live_… à chaque requête. Les clés émises avant le schéma actuel peuvent aussi s'authentifier avec l'en-tête historique x-imggen-key, toujours accepté.
- L'usage se mesure en crédits plutôt qu'avec un tarif fixe par appel, et le coût dépend de l'endpoint : la suppression d'arrière-plan coûte 1 crédit ; la suppression de filigrane, la suppression de texte, la restauration et la colorisation coûtent 2 ; l'agrandissement coûte 2 avec factor=2 et 4 avec factor=4 ; la génération d'images démarre à 3 et varie selon le modèle. 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 l'abonnement est actif.
- Un compte ImgGen gratuit inclut 50 crédits sans carte bancaire, de quoi évaluer les modèles dans les outils web. L'accès à l'API fait partie des forfaits payants Starter et Pro : il n'existe pas de palier d'API gratuit permanent, et nous préférons le dire clairement plutôt que d'en annoncer un qui bride ensuite en silence.
- 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.
- Synchrones. Aucun identifiant de job à interroger, aucune file à gérer, aucun webhook à configurer : l'image traitée se trouve dans le corps de la même réponse. Les requêtes sont soumises à un plafond de 60 secondes.
- 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.
- L'endpoint de suppression de filigrane accepte un lot de fichiers sous image[] et renvoie un tableau images. Tous les autres endpoints traitent une image par requête : pour du volume, lancez les requêtes en parallèle depuis votre propre worker, chaque appel étant indépendant.
- Pas pour le moment. L'API est du REST simple sur HTTPS avec des envois multipart, donc n'importe quel client HTTP convient, et la documentation fournit des exemples prêts à copier en cURL, Node.js et Python. Il n'existe pas encore de bibliothèque cliente officielle ni de spécification OpenAPI publiée.
Commencer
Lancez votre premier appel en cinq minutes
Créez une clé, copiez l'exemple cURL, et la suppression d'arrière-plan fonctionne. Une seule clé couvre les sept endpoints, sur tous les forfaits qui incluent l'accès à l'API.
Obtenir votre clé d'API