La API de remove.bg va a cerrar. Cambia una línea y conserva tu código.
La web independiente y la API de autoservicio de remove.bg terminan el . La API pasa a Leonardo.Ai (una empresa de Canva), lo que obliga a cambiar tu integración (anuncio de Leonardo.Ai). removebackground.dev acepta las mismas solicitudes: apunta tu código a nuestra URL, usa nuestra clave y listo.
La API de autoservicio de remove.bg termina el
La única línea que cambia
https://api.remove.bg/v1.0/removebghttps://removebackground.dev/v1.0/removebgLa misma cabecera X-Api-Key, con tu clave de removebackground.dev. Los mismos nombres de parámetros, las mismas cabeceras de respuesta y el mismo formato de error {"errors": [...]}.
Antes y después
Una integración típica en cuatro lenguajes. La clave sale de REMOVEBG_API_KEY, así que lo único que cambia es la URL resaltada.
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://api.remove.bg/v1.0/removebg
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://removebackground.dev/v1.0/removebg
¿Usas Zapier, Make o n8n?
Abre el paso de solicitud HTTP que llama a remove.bg (Zapier Webhooks, Make HTTP, n8n HTTP Request), cambia la URL por https://removebackground.dev/v1.0/removebg y el valor de X-Api-Key por tu clave de removebackground.dev. Deja todos los demás campos como están.
Compatibilidad de parámetros
Se acepta todo lo que envía tu solicitud a remove.bg. Algunas opciones no tienen efecto aquí, y lo indicamos abajo.
| Parámetro | Estado | Notas |
|---|---|---|
image_file / image_file_b64 / image_url | Compatible | Cuerpos multipart, urlencoded o JSON. JPG, PNG o WebP de hasta 25 MB. |
size | Compatible | auto, full, 4k y 50MP dan la resolución original (hasta 25 MP); preview, small y regular ≈ 0,25 MP; medium 1,5 MP; hd 4 MP. Siempre 1 crédito. |
format | Compatible | auto (PNG si hay transparencia; si no, JPG), png, jpg, webp y zip (color.jpg + alpha.png). |
crop / crop_margin | Compatible | px o % del sujeto, de 1 a 4 valores al estilo CSS ("10% 20%" = vertical, horizontal); como máximo 500px o 50% por lado. |
roi | Compatible | "x1 y1 x2 y2" en px o %: solo se conserva el sujeto dentro de la región. |
scale / position | Compatible | scale del 10% al 100% u original; position center, original o "x% y%". |
channels | Compatible | rgba (recorte) o alpha (máscara en escala de grises). |
bg_color | Compatible | Hex con o sin # (81d4fa), o un nombre de color. Un hex de 8 dígitos conserva el color y descarta su alfa. |
bg_image_url / bg_image_file | Compatible | El recorte se compone sobre tu imagen de fondo, ajustada en modo cover al tamaño de salida. |
Accept: application/json | Compatible | Devuelve { data: { result_b64, foreground_top, foreground_left, foreground_width, foreground_height } }. |
type / type_level | Aceptado, se ignora | El sujeto se detecta automáticamente; X-Type siempre es "other". |
semitransparency | Aceptado, se ignora | Los bordes suaves y las zonas semitransparentes salen tal cual de la máscara del modelo. |
shadow_type / shadow_opacity / add_shadow | Aceptado, se ignora | No se añaden sombras. |
Solicitudes largas | Diferencia | Esperamos hasta 110 segundos; si una imagen no está lista para entonces, recibes un 503 que puedes reintentar (no se cobra salvo que haya terminado). |
Cabeceras de respuesta
Una llamada correcta responde con los bytes de la imagen (image/png, image/jpeg, image/webp o application/zip) y estas cabeceras. Envía Accept: application/json para recibir result_b64 en su lugar.
| Cabecera | Significado |
|---|---|
X-Width / X-Height | Tamaño del resultado en píxeles. |
X-Credits-Charged | Créditos que usó esta imagen: siempre 1 (las imágenes fallidas cuestan 0). |
X-Type | Siempre "other" (la detección del sujeto es automática). |
X-Foreground-Top / -Left / -Width / -Height | Cuadro delimitador del sujeto en el resultado, en píxeles. |
X-Request-ID | Repite tu X-Request-ID, o un id generado. Extra. |
X-Matte-Confidence / X-Matte-Ambiguous-Ratio | Lo limpia que es la máscara (0–1) y la proporción de píxeles suaves. Extra: útil para marcar imágenes que conviene revisar. |
Errores
| Estado | Significado |
|---|---|
400 | Parámetro o imagen no válidos (códigos como invalid_size, invalid_crop_margin, missing_source, file_too_large, unknown_foreground). |
402 | insufficient_credits: recarga en la página de precios. |
403 | auth_failed: falta X-Api-Key o no es válida. |
429 | rate_limit_exceeded. |
500 / 503 | El procesamiento falló, superó el tiempo de espera o el servicio no está disponible momentáneamente. Reintenta; las imágenes fallidas son gratis. |
Consulta tu saldo con GET https://removebackground.dev/v1.0/account: la respuesta tiene el mismo formato de cuenta que remove.bg. Todos los detalles en la referencia de la API.
Créditos: 1 por imagen, y no caducan nunca
Cada imagen procesada con éxito cuesta 1 crédito, sea cual sea el tamaño o las opciones. Las imágenes fallidas son gratis. Las cuentas nuevas reciben 50 créditos gratis para hacer pruebas.
- Los créditos no caducanRecarga una vez y úsalos la semana que viene o el año que viene.
- Sin suscripciónPaquetes de pago único. No se renueva nada.
- Las imágenes fallidas son gratisSolo se usa un crédito cuando se elimina el fondo.
Lista de migración
- Obtén una clave de API de removebackground.devRegístrate (50 créditos gratis) y crea una clave en la página de tu cuenta.
- Cambia una líneaApunta tu código a https://removebackground.dev/v1.0/removebg y pon la nueva clave en la misma cabecera X-Api-Key.
- Prueba una imagenLanza una solicitud real y compara el resultado con lo que obtienes hoy.
- Cambia tu tráficoDespliega antes del 1 de diciembre de 2026 a las 9:00 CET. Recarga créditos una vez; no caducan nunca.
Preguntas frecuentes sobre la migración desde remove.bg
¿remove.bg va a cerrar?
La web independiente y la API de autoservicio de remove.bg terminan el 1 de diciembre de 2026 a las 9:00 CET. La API pasa a Leonardo.Ai (una empresa de Canva), lo que obliga a cambiar tu integración. Fuente: anuncio de Leonardo.Ai en https://www.leonardo.ai/news/removebg-api-leonardo.
¿Cuál es el sustituto más sencillo de la API de remove.bg?
removebackground.dev tiene un endpoint compatible con remove.bg. Cambia https://api.remove.bg/v1.0/removebg por https://removebackground.dev/v1.0/removebg, envía una clave de removebackground.dev en la misma cabecera X-Api-Key y conserva el resto de tu código: los nombres de parámetros, las cabeceras de respuesta y el formato de error coinciden.
¿Tengo que reescribir mi integración antes de diciembre de 2026?
No. Las solicitudes mantienen los mismos parámetros (image_file, image_url, size, format, crop, bg_color…) y reciben el mismo tipo de respuesta: los bytes de la imagen con las cabeceras X-Width, X-Height y X-Foreground-*, o JSON con result_b64. Solo cambian la URL y la clave.
¿Funciona con Zapier, Make o n8n?
Sí. En tu paso de solicitud HTTP (Zapier Webhooks, Make HTTP, n8n HTTP Request), cambia la URL por https://removebackground.dev/v1.0/removebg y el valor de X-Api-Key por tu clave de removebackground.dev. No cambia nada más.
¿Cuánto cuesta?
1 crédito por imagen procesada con éxito, sea cual sea el tamaño o las opciones. Sin suscripción: recargas únicas de 17 US$, 49 US$ o 99 US$, y los créditos no caducan nunca. Las imágenes fallidas son gratis. Las cuentas nuevas reciben 50 créditos gratis.
¿Qué parámetros de remove.bg son compatibles?
image_file, image_file_b64, image_url, size, format (auto, png, jpg, webp, zip), crop, crop_margin, roi, scale, position, channels, bg_color, bg_image_url y bg_image_file. type, type_level, semitransparency y las opciones de sombra se aceptan y se ignoran, así que las solicitudes que los envían siguen funcionando.
¿Puedo consultar mi saldo como antes?
Sí. GET https://removebackground.dev/v1.0/account con tu clave devuelve tus créditos en el formato de cuenta de remove.bg.
¿removebackground.dev tiene relación con remove.bg?
No. remove.bg es una marca registrada de su titular. removebackground.dev es un servicio independiente que acepta las mismas solicitudes de API.
Cámbiate antes del 1 de diciembre de 2026 a las 9:00 CET
La API de autoservicio de remove.bg termina el
Crea una clave, cambia una línea, prueba una imagen. 50 créditos gratis incluidos.
remove.bg es una marca registrada de su titular; removebackground.dev no tiene relación con ella.