API de eliminación de fondo
Elimina el fondo de una imagen y devuelve un archivo PNG transparente. No necesitas una clave API. No necesitas una cuenta. Una sola petición POST con una imagen es toda la llamada: no hay nada en lo que registrarse ni nada que esperar. Es una API gratuita de eliminación de fondos: una llamada a la API de eliminar fondo que funciona desde curl, Python, Node o cualquier otra cosa que pueda enviar un POST HTTP.
Última actualización: 28 de septiembre de 2026
Este es el mismo motor que BGNinja website funciona directamente a través de HTTP. Su uso es gratis, dentro de los límites que se indican a continuación. No es necesario que nos solicite acceso, ni hay ninguna clave que deba actualizarse.
Guía de inicio rápido
curl -s -o output.png \
-F "file=@input.jpg" \
https://bgninja.com/api/remove
Eso es todo. output.png es tu imagen con el fondo eliminado y un canal alfa en el lugar donde antes estaba el fondo.
¿Vas a dejar la API de remove.bg?
La página de la API de remove.bg dice que a partir del 1 de diciembre de 2026, la eliminación de fondos pasa a Leonardo.Ai. Si prefieres no registrarte en ningún sitio nuevo, el cambio a BGNinja es pequeño:
| remove.bg | BGNinja | |
|---|---|---|
| URL | https://api.remove.bg/v1.0/removebg | https://bgninja.com/api/remove |
| Campo de imagen | image_file | file |
| Color de fondo | bg_color | bg (hexadecimal de 6 dígitos, sin #; los nombres de colores como white se ignoran y dan transparencia) |
| Autenticación | X-Api-Key cabecera | ninguna, elimina la cabecera |
| Tamaño de salida | size (créditos por tamaño) | siempre a tu resolución completa, hasta 30 MP |
| Respuesta | bytes PNG | bytes PNG, mismo manejo |
Dos diferencias: el límite gratuito aquí es de 10 imágenes al día por dirección IP, y no hay entrada de URL de imagen. Envía directamente el archivo. Si manejas un volumen real, cuéntanos en el página de contacto primero. Para fotos individuales en el navegador, consulta la alternativa a remove.bg página y lo que significa el cierre de remove.bg.
Endpoint
| Método | POST |
|---|---|
| URL | https://bgninja.com/api/remove |
| Cuerpo | multipart/form-data |
| Autenticación | Ninguno |
Parámetros
| Nombre | Obligatorio | Función |
|---|---|---|
file | sí | La imagen. PNG, JPG, WEBP o HEIC. |
bg | no | Color hexadecimal sin el #por ejemplo ffffff. Superpone la imagen recortada sobre el color de fondo en lugar de dejarla transparente. Omítalo para mantener la transparencia. |
src | no | Una etiqueta que identifique tu aplicación, por ejemplo my-plugin. Puede contener hasta 32 caracteres, incluyendo letras, números y guiones. Esto solo nos ayuda a identificar qué integraciones se están utilizando. Cualquier otro dato se ignorará. |
Respuesta
Al tener éxito, obtienes HTTP 200 y los datos sin procesar de un archivo PNG, con Content-Type: image/pngLa llamada es síncrona: no hay ningún ID de trabajo, ni cola, ni nada que consultar. Escribe el contenido directamente en un archivo o pásalo a tu biblioteca de imágenes.
Límites
| Tamaño máximo de archivo | 99 MB |
|---|---|
| Resolución máxima | 30 megapíxeles |
| Ejecuciones simultáneas | 2 por dirección IP |
| Solicitudes por día | 10 usos gratis, se restablecen a medianoche |
Estos límites son reales y se aplican. No hay un nivel ilimitado oculto, y el resultado gratuito es la imagen en resolución completa en lugar de una vista previa reducida.
Errores
En caso de error, se devolverá un archivo JSON que contendrá un único error clave, no como imagen. Compruebe el código de estado antes de guardar el contenido en un archivo.
| Estado | Significado |
|---|---|
400 | El archivo no es una imagen que podamos leer. Formato incorrecto o los bytes están dañados. |
402 | Las 10 solicitudes gratuitas de hoy ya se han agotado. El contador se reinicia a medianoche. |
413 | Demasiado grande. O bien, supera los 99 MB, o tiene más de 30 megapíxeles. |
422 | No. file campo en la solicitud. Este se devuelve bajo una detail clave en lugar de error. |
429 | Ya tiene dos solicitudes en curso desde esta dirección. Espere a que termine una y vuelva a intentarlo. |
$ curl -s -F "file=@notes.txt" https://bgninja.com/api/remove
{"error":"can't read this file (TXT), please upload a photo (JPG, PNG, WEBP, HEIC)."}
A 429 trata de cuántas se ejecutan a la vez, así que vuelve a intentarlo con la misma imagen poco después. Un 402 es el recuento diario, por lo que reintentar antes de la medianoche no servirá de nada.
Ejemplos
Python
import requests
with open("input.jpg", "rb") as f:
r = requests.post(
"https://bgninja.com/api/remove",
files={"file": f},
data={"src": "my-app"},
timeout=120,
)
r.raise_for_status()
open("output.png", "wb").write(r.content)
Node
import { readFile, writeFile } from "node:fs/promises";
const body = new FormData();
body.append("file", new Blob([await readFile("input.jpg")]), "input.jpg");
body.append("src", "my-app");
const r = await fetch("https://bgninja.com/api/remove", { method: "POST", body });
if (!r.ok) throw new Error(`HTTP ${r.status}`);
await writeFile("output.png", Buffer.from(await r.arrayBuffer()));
Un fondo blanco uniforme en lugar de transparencia.
curl -s -o output.png \
-F "file=@input.jpg" \
-F "bg=ffffff" \
https://bgninja.com/api/removeQué le ocurre a su imagen.
Se procesa en la memoria y se transmite directamente. No se guarda nada en el disco, por lo que no hay una copia almacenada en algún lugar esperando a ser eliminada o filtrada. Mantenemos un registro de la cantidad de solicitudes que recibimos y su tamaño, pero no de nada que identifique la imagen en sí.
Usándolo en tu propio proyecto
Eres bienvenido a basarte en esto, incluso en algo por lo que cobres. Una condición y una petición:
- pasa a
srcetiqueta para que podamos verificar que la integración existe y evitar que deje de funcionar. - Condición: si usas BGNinja en un sitio web o en una aplicación que otras personas utilicen, menciónanos (“Background removal by bgninja”, enlazando a bgninja.com) en algún lugar donde los usuarios puedan verlo, como el pie de página o una página de créditos. Es la razón principal por la que podemos mantener esto gratis y sin una clave. Usarlo en tus propios archivos no requiere crédito.
Si planeas utilizarlo para procesar una gran cantidad de datos, no dudes en ponerte en contacto con nosotros página de contacto Primero, preferimos que nos cuentes lo que necesitas antes de imponerte restricciones.
Preguntas
¿Es esto un reemplazo para la API de remove.bg?
Sí. La API de remove.bg se traslada a Leonardo.Ai el 1 de diciembre de 2026. Aquí cambias la URL a https://bgninja.com/api/remove, renombras image_file a file y bg_color a bg, y eliminas la cabecera X-Api-Key. El límite gratuito es de 10 imágenes al día.
¿Necesito una clave API?
No. No hay clave, ni cuenta, ni necesidad de registrarse. El punto final está abierto.
¿Cómo puedo recortar un fragmento de un vídeo?
Sí, siempre y cuando se respeten los límites indicados. No es una versión de prueba y no es necesario ingresar datos de ninguna tarjeta. El [elemento] opcional pase aumenta los límites del sitio web; los límites de la API que se indican aquí se aplican a todos los usuarios.
¿Existe un límite de solicitudes por día?
10 solicitudes al día en la versión gratuita, con un restablecimiento a medianoche. La única otra limitación es que solo se pueden realizar dos solicitudes simultáneamente por dirección IP.
¿Puedo obtener la máscara recortada en lugar de la imagen?
Hoy no. El punto final devuelve la imagen PNG combinada. Si necesita la máscara por separado, indíquenoslo en el página de contacto y lo revisaremos.
¿Este punto final seguirá funcionando?
Es el mismo punto final que utiliza nuestro propio sitio web, por lo que no desaparecerá repentinamente. Si la estructura de la solicitud alguna vez tiene que cambiar, la forma anterior seguirá funcionando en paralelo.
¿Es la respuesta asíncrona?
No. La llamada es síncrona; el cuerpo de la respuesta HTTP es la imagen PNG finalizada. No hay ningún ID de trabajo ni nada que consultar.
¿Qué formatos de imagen acepta?
Se introducen archivos PNG, JPG, WEBP y HEIC. Se obtiene un archivo PNG con un canal alfa o un fondo plano si se introduce un color hexadecimal en el parámetro bg.
¿Qué ocurre con la imagen que envío?
Se procesa en la memoria y se transmite directamente. No se guarda nada en el disco, por lo que no hay ninguna copia almacenada que eliminar.
¿Qué ocurre si envío demasiadas solicitudes?
Una tercera solicitud ejecutándose al mismo tiempo desde una dirección IP recibe un HTTP 429: espera a que termine una y vuelve a intentarlo. Después de 10 solicitudes en un día, obtienes un HTTP 402 hasta la medianoche.
Los términos de uso se encuentran en página de términosy cómo utilizamos los datos se explica en página de privacidad.