Desarrolladores

API para quitar fondos

Las mismas solicitudes que la API de remove.bg y las mismas respuestas. Cambia la URL base y la clave; el resto del código no se toca.

Cómo pasar de remove.bg

remove.bg anunció que su servicio independiente cierra el 1 de diciembre de 2026 y que ese mismo día dejan de funcionar las solicitudes de la API de autoservicio, que pasa a Leonardo.Ai. Si tu código llama a api.remove.bg, apúntalo aquí:

Anteshttps://api.remove.bg/v1.0/removebg
Despuéshttps://imagic-ai.com/api/v1.0/removebg

La cabecera sigue siendo X-Api-Key, los campos conservan sus nombres y los errores mantienen el formato de remove.bg, así que las bibliotecas cliente que permiten fijar la URL base funcionan tal cual.

Qué cambia con el cierre del 1 de diciembre y qué hacer primero

Obtén una clave

  1. Inicia sesión con Google.
  2. Abre Mi cuenta y crea una clave en Claves de la API para quitar fondos.
  3. Copia la clave cuando aparezca. Solo se muestra una vez.
Crear una clave

Inicio rápido

Envía la imagen como archivo, en base64 o como URL pública. El cuerpo de la respuesta es la imagen terminada.

curl
curl -H "X-Api-Key: $IMAGIC_API_KEY" \
  -F "image_file=@photo.jpg" \
  -F "size=auto" \
  -o no-bg.png \
  https://imagic-ai.com/api/v1.0/removebg
Python
import os, requests

response = requests.post(
    "https://imagic-ai.com/api/v1.0/removebg",
    files={"image_file": open("photo.jpg", "rb")},
    data={"size": "auto"},
    headers={"X-Api-Key": os.environ["IMAGIC_API_KEY"]},
)
response.raise_for_status()
with open("no-bg.png", "wb") as out:
    out.write(response.content)
Node.js
import { readFile, writeFile } from "node:fs/promises";

const form = new FormData();
form.append("image_file", new Blob([await readFile("photo.jpg")]), "photo.jpg");
form.append("size", "auto");

const res = await fetch("https://imagic-ai.com/api/v1.0/removebg", {
  method: "POST",
  headers: { "X-Api-Key": process.env.IMAGIC_API_KEY },
  body: form,
});
if (!res.ok) throw new Error(JSON.stringify(await res.json()));
await writeFile("no-bg.png", Buffer.from(await res.arrayBuffer()));

Campos de la solicitud

POST /api/v1.0/removebg acepta multipart/form-data, application/x-www-form-urlencoded o JSON. Envía solo uno de los tres campos de imagen.

CampoValoresNotas
image_filearchivoJPG, PNG o WebP de hasta 22 MB.
image_file_b64cadena base64El mismo archivo en base64. Se acepta el prefijo data: URL.
image_urlURL http(s)La descargamos nosotros. Solo direcciones públicas y puertos web estándar, hasta 3 redirecciones.
sizepreview · small · regular · medium · hd · full · 4k · auto · 50MPpreview/small/regular: hasta 0,25 MP. medium: 1,5 MP. hd: 4 MP. full/4k/auto/50MP: hasta 25 MP (PNG hasta 10 MP). Cada tamaño cuenta como una imagen.
formatauto · png · jpg · webp · zipauto devuelve PNG si el resultado tiene transparencia y JPG si no. zip contiene color.jpg y alpha.png, como en remove.bg.
channelsrgba · alphaalpha devuelve solo la máscara, en escala de grises.
bg_colorhex (81d4fa, #81d4fa77) o un nombre de colorRellena el fondo eliminado. Un JPG sin bg_color se aplana sobre blanco.
croptrue · falseRecorta el resultado al sujeto.
crop_marginp. ej. 30px o 10%Espacio alrededor del sujeto recortado. Hasta 500px o 50%.
typeauto · person · product · car · animal · graphic · transportationSe acepta por compatibilidad. Se devuelve en X-Type; no cambia el recorte.
modelfast · preciseOpción propia (remove.bg no la tiene). fast, la predeterminada: nuestro modelo estándar. precise: bordes más finos en cabello, partes delgadas y vidrio, algo más lento. Ambos cuentan como una imagen; la cabecera X-Imagic-Model indica cuál se usó.

No se admiten scale, position, roi, bg_image_url, bg_image_file ni las opciones de sombra. Las solicitudes que los usan reciben un 400 en lugar de una imagen distinta sin aviso.

Respuesta

Por defecto el cuerpo es la propia imagen, con estas cabeceras: X-Width, X-Height, X-Type, X-Foreground-Top, X-Foreground-Left, X-Foreground-Width, X-Foreground-Height, X-Credits-Charged (siempre 1) y X-RateLimit-Limit / -Remaining / -Reset para el cupo diario. Una imagen pagada con un crédito también lleva X-Imagic-Paid: 1 y X-Imagic-Credit-Balance. Envía Accept: application/json para recibir JSON:

Accept: application/json
{
  "data": {
    "result_b64": "iVBORw0KGgo…",
    "foreground_top": 115,
    "foreground_left": 477,
    "foreground_width": 637,
    "foreground_height": 824
  }
}

Cupo restante

GET /api/v1.0/account devuelve la estructura de cuenta de remove.bg. api.free_calls son las imágenes gratis que te quedan hoy, credits.payg es el saldo de créditos de la cuenta y credits.total es la suma de ambos.

Errores

Los errores usan el formato de remove.bg, que se muestra abajo. Una solicitud fallida no consume imágenes.

{"errors": [{"title": "Daily limit of 50 free images reached. …", "code": "rate_limit_exceeded"}]}
EstadoSignificado
400Entrada incorrecta: sin imagen, dos imágenes, un archivo ilegible, una opción no admitida o una image_url que no podemos o no debemos descargar.
403Falta la cabecera X-Api-Key, o la clave es incorrecta o está revocada.
422El modelo solicitado no está disponible ahora (código model_unavailable). Reintenta con model=fast; la imagen no se cuenta.
429Ya usaste las 50 imágenes gratis de hoy y la cuenta no tiene créditos, o llegó a 1000 imágenes de pago hoy. Retry-After indica los segundos hasta que se renueven las imágenes gratis.
503El procesamiento no está disponible por ahora. Vuelve a intentarlo en un momento.

Límites

  • 50 imágenes al día por cuenta, compartidas por todas sus claves. Hasta 3 claves activas por cuenta para poder rotarlas.
  • Subidas de hasta 22 MB. Salida de hasta 25 MP, o 10 MP en PNG.
  • Las solicitudes se ponen en cola y se procesan unas pocas a la vez. Cuenta con unos segundos por imagen, más en fotos grandes.
  • Después de las 50 imágenes gratis, cada imagen usa un crédito del saldo de la cuenta, hasta 1000 imágenes de pago al día. Los créditos se compran en la página de la cuenta (100 por 5 US$ o 500 por 19 US$) y no caducan.

Qué esperar de los recortes

Los recortes salen del modelo isnet-general-use, el mismo del Eliminador de Fondos. Es fiable con productos, personas y animales sobre fondos normales. Donde más flojea es en el cabello fino, el vidrio y los sujetos del mismo color que el fondo, y ahí el modelo de remove.bg puede hacerlo mejor. Prueba con algunas de tus imágenes antes de mover un flujo en producción.

Preguntas

¿Es un sustituto oficial de remove.bg?
No. Imagic AI no está vinculado a remove.bg, Canva ni Leonardo.Ai. La API acepta el formato de solicitud de remove.bg para que el código existente siga funcionando.
¿La API es gratis?
Sí. Cada cuenta tiene 50 imágenes al día sin coste. Cada tamaño, incluido preview, cuenta como una imagen. A partir de ahí, cada imagen usa un crédito (100 créditos cuestan 5 US$).
¿Funcionan las bibliotecas cliente oficiales de remove.bg?
Las que permiten fijar la URL base funcionan cambiándola a https://imagic-ai.com/api. Las que llevan api.remove.bg fijo necesitan cambiar esa línea en su código o un pequeño envoltorio.
¿Guardan mis imágenes?
Las imágenes enviadas a la API se procesan y se devuelven en la respuesta. No se añaden a ninguna galería ni se usan para entrenar modelos.

¿Solo necesitas unas pocas imágenes, sin código?

Usar el Eliminador de Fondos