1 crédito por llamada
API de eliminación de fondos
Elimina el fondo de tus imágenes por código con una sola solicitud POST. Una clave de API, salida en PNG transparente y un servicio sin estado que nunca almacena las imágenes que envías.
- REST · JSON
- Sin marca de agua
- No se almacena nada
POST /v1/remove-background
¿Qué es la API de eliminación de fondos?
La API de eliminación de fondos de ImgGen AI es un endpoint REST que separa el sujeto en primer plano del fondo de una foto y devuelve un PNG transparente. Subes una imagen por HTTPS, la IA detecta el sujeto automáticamente y el recorte vuelve codificado en base64 dentro de la respuesta JSON. No hace falta ninguna máscara ni selección manual.
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 Background Remover.
Parámetros de la solicitud
Envía una solicitud POST a https://app.imggen.ai/v1/remove-background, autenticada con una clave de API en la cabecera Authorization.
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| image | file | OBLIGATORIO | — | The input image to process. Accepts JPEG (JPG), PNG and WebP, up to 25 MB. |
¿Cómo integro la API de eliminación de fondos?
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-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 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-background",
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": "Background 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.
Salida en PNG transparente
El resultado se devuelve con un canal alfa real, así que puedes componerlo sobre cualquier fondo, color o plantilla sin una segunda solicitud.
No hace falta máscara
La detección del sujeto es automática: el primer plano se separa del fondo por ti. No hay nada que pintar, trazar ni pasar como segundo parámetro: envía la imagen de entrada y lee el resultado.
No se almacena nada
La entrada se guarda en un objeto temporal mientras dura la llamada y se elimina después. Útil cuando procesas fotos de clientes que no tienes permitido conservar.
¿Para qué se usa la API de eliminación de fondos?
Dónde ponen los equipos este endpoint en producción para procesar imágenes de forma programática y a escala.
Catálogos de comercio electrónico
Quita el fondo de las imágenes de producto de tus proveedores al subirlas para que cada anuncio muestre un recorte limpio y homogéneo sin ningún paso de edición manual.
Marketplaces y anuncios clasificados
Normaliza automáticamente las fotos que suben los vendedores. Pasa cada subida por el endpoint y guarda el PNG transparente junto al original.
Print-on-demand
Aísla ilustraciones y sujetos antes de componerlos sobre mockups, para que las vistas previas se rendericen bien en cualquier tamaño de producto.
SaaS de diseño y edición
Ofrece a tus usuarios eliminación de fondos en un clic dentro de tu propio producto sin entrenar un modelo, alojarlo ni ejecutar tu propia inferencia en AWS ni en ningún otro sitio.
¿Cuánto cuesta la API de eliminación de fondos?
Cada llamada correcta cuesta 1 crédito, 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 fondos 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 fondos
- Es un endpoint HTTP que recibe una foto y devuelve esa misma foto con el fondo eliminado y el sujeto conservado sobre una capa transparente. Al ser una API y no un editor, puedes llamarla desde un proceso de backend, un worker de cola o el gestor de subidas de tus usuarios y procesar miles de imágenes sin que nadie abra un navegador.
- Crea una clave de API en tu cuenta de ImgGen y envía por POST un formulario multipart con un campo image a https://app.imggen.ai/v1/remove-background con una cabecera Authorization: Bearer. La respuesta es JSON; decodifica el campo image en base64 y escríbelo en disco o en tu almacenamiento de objetos. En esta página tienes ejemplos funcionales en cURL, Node.js y Python.
- Un crédito por llamada correcta: el endpoint más barato de la API. Starter incluye 400 créditos al mes por 9,99 $, es decir unas 400 eliminaciones de fondo, y Pro incluye 1.400 por 29,99 $. Los créditos no usados se acumulan mientras tu suscripción siga activa, y las llamadas fallidas se reembolsan automáticamente, así que solo se te cobra por las imágenes que vuelven.
- Puedes crear una cuenta y probar las herramientas de IA con 50 créditos gratuitos y sin tarjeta. El acceso a la API forma parte de los planes de pago Starter y Pro; no hay un nivel de API gratuito permanente, y preferimos decirlo antes que anunciar uno que luego te limite en silencio.
- 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.
- Sí. Todos los planes, incluido el gratuito, incluyen derechos de uso comercial completos, y ningún resultado lleva marca de agua. Puedes vender, imprimir o publicar cualquier cosa que devuelva la API.
- El endpoint devuelve un PNG transparente, así que componer un nuevo color, degradado o telón de fondo es algo que haces en tu propio flujo, sin una segunda llamada a la API. El editor web de ImgGen también tiene un generador de fondos si prefieres fondos generados por IA en lugar de tus propios recursos.
Empezar
Empieza a llamar a la API de eliminación de fondos
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