2 créditos por llamada
API de eliminación de marcas de agua
Detecta y borra marcas de agua de tus imágenes en una sola solicitud. El inpainting generativo reconstruye los píxeles que había detrás de la marca, y este es el único endpoint que además acepta un lote de imágenes.
- REST · JSON
- Sin marca de agua
- No se almacena nada
POST /v1/remove-watermark
¿Qué es la API de eliminación de marcas de agua?
La API de eliminación de marcas de agua de ImgGen AI es un endpoint REST que localiza una marca de agua en una imagen y reconstruye el contenido que hay debajo. La detección es automática, así que no hace falta ninguna máscara, y el inpainting generativo rellena la zona despejada para que encaje con su entorno en lugar de difuminarla. La imagen limpia se devuelve en la misma respuesta.
Es uno de los siete endpoints de la API de edición de imágenes de ImgGen AI, que comparten una única clave de API, una única URL base y la misma forma de solicitud y respuesta. Si además necesitas esta función en el navegador y no desde código, el mismo modelo de IA impulsa la herramienta Watermark Remover.
Parámetros de la solicitud
Envía una solicitud POST a https://app.imggen.ai/v1/remove-watermark, autenticada con una clave de API en la cabecera Authorization.
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| image | file | OBLIGATORIO | — | Formato por lotes. Envía varios archivos bajo image[] para procesarlos en una sola solicitud; la respuesta devuelve un array images más failedImages con los que no se hayan podido procesar. |
| image[] | file[] | opcional | — | 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. |
¿Cómo integro la API de eliminación de marcas de agua?
Crea una clave de API en tu cuenta de ImgGen, guárdala como variable de entorno y llama al endpoint. Esta es la misma solicitud en cURL, Node.js y 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"]))Respuesta
Una llamada correcta devuelve JSON. El resultado viene codificado en base64: decodifícalo antes de escribirlo en disco o en tu almacenamiento de objetos. Cada respuesta correcta incluye además una cabecera X-Credit-Remaining con tu saldo tras la llamada.
{
"success": true,
"message": "Watermark removed successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}Límites y comportamientos que conviene conocer
El endpoint acepta JPEG (JPG), PNG y WebP con un tamaño máximo de archivo de 25 MB, y responde de forma síncrona en menos de 60 segundos: no hay ningún trabajo que consultar ni ningún webhook que configurar.
Subidas por lotes
Este es el único endpoint de ImgGen que acepta lotes. Envía varios archivos bajo image[] y la respuesta traerá un array images junto a failedImages con todo lo que no se haya procesado.
Detección automática
No hay ningún parámetro de máscara, recuadro ni pincel. El modelo localiza la marca de agua por sí solo, así que una única forma de solicitud sirve para imágenes de origen muy distintas.
Edita solo lo que sea tuyo
Quitar la marca de agua de una imagen que no te pertenece o que no tienes licencia para editar puede vulnerar los derechos de autor. Usa este endpoint con tus propios recursos o con imágenes que tengas derecho a modificar.
¿Para qué se usa la API de eliminación de marcas de agua?
Dónde ponen los equipos este endpoint en producción para procesar imágenes de forma programática y a escala.
Recuperar tu propio archivo
Elimina la marca de agua antigua de tu estudio de miles de imágenes propias cuando cambies de identidad de marca, sin reprocesar los originales a mano.
Flujos con material con licencia
Limpia los recursos con marca de previsualización que tengas licenciados, dentro de un flujo automatizado que publica en tu CMS.
Entrega fotográfica
Quita las marcas de prueba de las imágenes una vez que el cliente ha pagado, directamente desde tu sistema de pedidos.
Producción de plantillas
Elimina las marcas superpuestas del material de origen que te pertenece antes de componerlo en una plantilla o un mockup.
¿Cuánto cuesta la API de eliminación de marcas de agua?
Cada llamada correcta cuesta 2 créditos, así que tu coste real por imagen depende del plan que tengas. Los créditos salen de tu plan y se comparten entre todos los endpoints y el editor web, de modo que no compras una cuota separada por herramienta. Una llamada fallida se reembolsa automáticamente. Consulta todos los detalles en la página de precios.
| Plan | Precio | Créditos | API |
|---|---|---|---|
| Free | $0 | 50 créditos gratuitos de una sola vez | Sin acceso a la API |
| Starter | $9.99 / month | 400 créditos / mes | Acceso a la API incluido |
| Pro | $29.99 / month | 1.400 créditos / mes | Acceso a la API + soporte prioritario |
| Enterprise | Custom | Volumen personalizado | Infraestructura dedicada |
Costes en créditos y límites verificados por última vez el 2026-08-27.
Endpoints y herramientas relacionados
Los equipos que usan la API de eliminación de marcas de agua suelen recurrir después a estos.
También disponibles: Escalado de imágenes, Restauración de fotos, Coloreado de fotos, Generación de imágenes.
Preguntas frecuentes sobre la API de eliminación de marcas de agua
- Es un endpoint HTTP que recibe una imagen con una marca de agua y devuelve esa misma imagen con la marca eliminada y la zona de debajo reconstruida. Como la detección es automática, no tienes que indicarle dónde está la marca, y eso es justo lo que la hace utilizable en un proceso por lotes desatendido.
- Sí. La eliminación de marcas de agua es el único endpoint de ImgGen con soporte para lotes: envía tus archivos bajo image[] en lugar de image y la respuesta devolverá un array images más un array failedImages con lo que no se haya podido procesar. El resto de endpoints procesan una sola imagen por solicitud.
- Dos créditos por imagen correcta, incluida cada imagen de un lote. Starter incluye 400 créditos al mes por 9,99 $, Pro incluye 1.400 por 29,99 $, y los créditos no usados se acumulan mientras tu suscripción siga activa.
- Puedes quitar marcas de agua sin coste en la herramienta web de ImgGen usando tus 50 créditos iniciales, sin tarjeta. La API en sí forma parte de los planes de pago Starter y Pro. Las API gratuitas de eliminación de marcas de agua suelen existir como pruebas o demos con límites muy estrictos, no como algo sobre lo que construir un producto.
- Los asistentes generalistas a veces pueden editar una imagen, pero no están hechos para esto: no detectan la marca de forma fiable, a menudo vuelven a generar la imagen entera en lugar de reconstruir solo la zona afectada, y no hay una forma de solicitud estable contra la que automatizar. Un endpoint de inpainting dedicado te da una salida consistente y un contrato sobre el que construir.
- Depende por completo de quién sea el propietario de la imagen. Quitar la marca de agua de tus propias fotografías, o de recursos que hayas licenciado con derecho a editarlos, no supone ningún problema. Quitarla de la obra protegida de otra persona para usarla sin permiso sí lo supone, y este endpoint no está pensado para eso.
- La API acepta archivos JPEG (JPG), PNG y WebP de hasta 25 MB por imagen. Los resultados se devuelven como una imagen codificada en base64 dentro de la respuesta JSON.
- No. La API no guarda estado: no crea ningún proyecto, no guarda ningún archivo ni conserva tu imagen. Tu subida se escribe en un objeto temporal, se procesa y se elimina en cuanto se devuelve la respuesta. Lo único que se conserva es un registro de uso que anota que hubo una llamada y cuántos créditos costó. Tus imágenes nunca se usan para entrenar modelos.
- Con la API no. La eliminación de marcas de agua en vídeo está disponible como herramienta web en imggen.ai, pero no hay ningún endpoint de vídeo en la API: todas las rutas /v1 procesan imágenes sueltas.
Empezar
Empieza a llamar a la API de eliminación de marcas de agua
Una sola clave desbloquea los siete endpoints. Sin marca de agua, con derechos comerciales completos y sin que se almacene nada de lo que envías una vez devuelta la respuesta.
Obtén tu clave de API