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.

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.

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. 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. credits.total y api.free_calls son las imágenes que te quedan hoy.

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 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.
429Ya usaste las 50 imágenes de hoy. Retry-After indica los segundos hasta que se renueve el cupo.
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.
  • Todavía no hay plan de pago, así que por ahora el cupo diario es el máximo.

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.
¿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