2 crédits par appel
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.
- REST · JSON
- Sans filigrane
- Rien n'est stocké
POST /v1/remove-watermark
Qu'est-ce que l'API de suppression de filigrane ?
L'API de suppression de filigrane ImgGen AI est un endpoint REST qui repère un filigrane dans une image et reconstruit le contenu situé en dessous. La détection est automatique, aucun masque n'est donc nécessaire, et l'inpainting génératif remplit la zone dégagée pour qu'elle s'accorde à son entourage plutôt que de la flouter. L'image nettoyée est renvoyée dans la même 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 Watermark Remover.
Paramètres de la requête
Envoyez une requête POST vers https://app.imggen.ai/v1/remove-watermark, authentifiée avec une clé d'API dans l'en-tête Authorization.
| Paramètre | Type | Obligatoire | Par défaut | Description |
|---|---|---|---|---|
| image | file | OBLIGATOIRE | — | Forme par lot. Envoyez plusieurs fichiers sous image[] pour les traiter en une seule requête ; la réponse renvoie un tableau images ainsi que failedImages pour ceux qui n'ont pas pu être traités. |
| image[] | file[] | facultatif | — | Batch form. Send multiple files under image[] to process them in one request; the response returns an images array plus failedImages for any that could not be processed. |
Comment intégrer l'API de suppression de filigrane ?
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/remove-watermark' \
--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-watermark', {
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/remove-watermark",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
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": "Watermark removed 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.
Envois par lot
C'est le seul endpoint ImgGen qui accepte un lot. Envoyez plusieurs fichiers sous image[] et la réponse contiendra un tableau images à côté de failedImages listant tout ce qui n'a pas été traité.
Détection automatique
Il n'y a aucun paramètre de masque, de cadre ou de pinceau. Le modèle localise le filigrane lui-même : une seule forme de requête fonctionne sur des images sources très différentes.
Ne modifiez que ce qui vous appartient
Retirer le filigrane d'une image qui ne vous appartient pas ou que vous n'avez pas la licence de modifier peut constituer une contrefaçon. Utilisez cet endpoint sur vos propres visuels, ou sur des images que vous avez le droit de modifier.
À quoi sert l'API de suppression de filigrane ?
Là où les équipes mettent cet endpoint en production pour traiter des images par programmation, à grande échelle.
Récupérer vos propres archives
Retirez l'ancien filigrane de votre studio de milliers de vos propres images lors d'un changement d'identité de marque, sans retraiter les originaux à la main.
Flux avec contenus sous licence
Nettoyez les visuels marqués « aperçu » que vous avez sous licence, dans un pipeline automatisé qui publie vers votre CMS.
Livraison photographique
Retirez les marques d'épreuve des images une fois que le client a payé, directement depuis votre système de commandes.
Production de gabarits
Effacez les marques incrustées du matériel source qui vous appartient avant de le composer dans un gabarit ou un mockup.
Combien coûte l'API de suppression de filigrane ?
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 suppression de filigrane se tournent ensuite généralement vers ceux-ci.
Également disponibles : Agrandissement d'images, Restauration de photos, Colorisation de photos, Génération d'images.
FAQ sur l'API de suppression de filigrane
- C'est un endpoint HTTP qui reçoit une image contenant un filigrane et renvoie cette même image avec la marque retirée et la zone située derrière reconstruite. Comme la détection est automatique, vous n'avez pas à indiquer où se trouve le filigrane — et c'est précisément ce qui la rend utilisable dans un traitement par lot sans surveillance.
- Oui. La suppression de filigrane est le seul endpoint ImgGen à gérer les lots : envoyez vos fichiers sous image[] au lieu de image et la réponse renverra un tableau images ainsi qu'un tableau failedImages pour tout ce qui n'a pas pu être traité. Tous les autres endpoints traitent une seule image par requête.
- Deux crédits par image réussie, y compris pour chaque image d'un lot. Starter inclut 400 crédits par mois à 9,99 $, Pro en inclut 1 400 à 29,99 $, et les crédits non utilisés sont reportés tant que l'abonnement est actif.
- Vous pouvez retirer des filigranes sans frais dans l'outil web ImgGen avec vos 50 crédits de départ, sans carte bancaire. L'API elle-même fait partie des forfaits payants Starter et Pro. Les API gratuites de suppression de filigrane existent généralement comme essais ou démos très limitées, pas comme une base sur laquelle construire un produit.
- Les assistants généralistes savent parfois modifier une image, mais ils ne sont pas conçus pour cela : ils ne détectent pas la marque de façon fiable, ils regénèrent souvent l'image entière au lieu de reconstruire seulement la zone concernée, et il n'existe pas de forme de requête stable à automatiser. Un endpoint d'inpainting dédié vous donne un résultat cohérent et un contrat sur lequel bâtir.
- Cela dépend entièrement de qui possède l'image. Retirer le filigrane de vos propres photographies, ou de visuels que vous avez sous licence avec le droit de les modifier, ne pose aucun problème. Le retirer de l'œuvre protégée d'un tiers pour l'utiliser sans autorisation, si — et cet endpoint n'est pas prévu pour cela.
- 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.
- Pas via l'API. La suppression de filigrane sur vidéo est disponible comme outil web sur imggen.ai, mais il n'existe aucun endpoint vidéo dans l'API — toutes les routes /v1 traitent des images individuelles.
Commencer
Commencez à appeler l'API de suppression de filigrane
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