Referencia de la API para quitar fondos

Consulta parámetros, formatos de respuesta y diferencias con la API de remove.bg. Revisa ejemplos con archivos, URL y Base64 y los límites de cada entrada.

POST https://removebgtool.net/v1.0/removebg

curl --fail-with-body --max-time 180 \
  -H 'X-API-Key: YOUR_API_KEY' \
  -F 'image_file=@image.jpg' \
  -F 'size=auto' \
  'https://removebgtool.net/v1.0/removebg' -o no-bg.png

Solicitud

Envía X-API-Key. Usa multipart/form-data con image_file; JSON o datos URL-encoded admiten image_url o image_file_b64. Proporciona una sola fuente. crop=false y format=auto por defecto: PNG para transparencia y JPG para salida opaca. bg_color acepta nombres CSS o hex de 3/4/6/8 dígitos. JPG convierte la transparencia en blanco.

curl --fail-with-body --max-time 180 \
  -H 'X-API-Key: YOUR_API_KEY' \
  -F 'image_url=https://example.com/photo.jpg' \
  -F 'format=png' \
  'https://removebgtool.net/v1.0/removebg' -o result.png

# JSON input and JSON output
curl --fail-with-body --max-time 180 \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  --data '{"image_file_b64":"YOUR_PADDED_BASE64","format":"png"}' \
  'https://removebgtool.net/v1.0/removebg'

import requests

with open('image.jpg', 'rb') as image:
    response = requests.post(
        'https://removebgtool.net/v1.0/removebg',
        headers={'X-API-Key': 'YOUR_API_KEY'},
        files={'image_file': image},
        data={'size': 'auto'},
        timeout=180,
    )
response.raise_for_status()
with open('no-bg.png', 'wb') as output:
    output.write(response.content)

import { readFile, writeFile } from 'node:fs/promises';

const form = new FormData();
form.append('image_file', new Blob([await readFile('image.jpg')]), 'image.jpg');
form.append('size', 'auto');
const response = await fetch('https://removebgtool.net/v1.0/removebg', {
  method: 'POST',
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
  body: form,
  signal: AbortSignal.timeout(180000),
});
if (!response.ok) throw new Error(await response.text());
await writeFile('no-bg.png', Buffer.from(await response.arrayBuffer()));

Respuesta

HTTP 200 devuelve los bytes de la imagen. Con Accept: application/json recibes data.result_b64 y dimensiones. Cabeceras: X-Width, X-Height, X-Credits-Charged, X-Foreground-Top/Left/Width/Height y X-Request-ID. Las coordenadas se refieren al lienzo de entrada normalizado. No hay clasificación ni X-Type. GET /v1.0/account devuelve data.attributes.credits y api.free_calls (0).

{
  "data": {
    "result_b64": "...",
    "result_width": 625,
    "result_height": 400,
    "credits_charged": 1
  }
}

Límites y diferencias

Entrada: ≤22 MB, ≤50 MP, cada lado entre 33 y 9999 píxeles, JPG/PNG/WebP de un fotograma. Las URL HTTPS deben ser públicas, directas y usar el puerto 443; se rechazan redirecciones y redes privadas. size usa preview (0,25 MP) por defecto; medium=1,5 MP, hd=4 MP, full/4k/auto=25 MP, 50MP=50 MP. PNG y auto tienen un límite de 10 MP. No se amplían imágenes. A diferencia de remove.bg, auto no elige tamaño según el saldo.

La API usa los créditos existentes de tu cuenta. El cargo actual por imagen aparece en el panel y en X-Credits-Charged. La vista previa cuesta lo mismo que la resolución completa. No se incluye una cuota mensual gratuita adicional de API.

Errores y reintentos

400 entrada o parámetros inválidos · 402 créditos insuficientes · 403 clave o plan inválido · 409 conflicto/en curso/caducidad de idempotencia · 415 codificación no compatible · 429 límite de solicitudes · 502/503 fallo o saturación del proveedor · 504 tiempo agotado. Respeta Retry-After en 429/503 y usa reintentos exponenciales para 5xx transitorios. Guarda las claves en el servidor.

{
  "errors": [
    {
      "title": "Insufficient credits.",
      "code": "insufficient_credits"
    }
  ]
}

Idempotency-Key es opcional: reutiliza la misma clave, imagen y parámetros para repetir un resultado exitoso durante 10 minutos sin otro cargo. La repetición conserva X-Credits-Charged y añade X-Idempotent-Replayed: true. Las solicitudes en curso devuelven 409. Las claves fallidas o caducadas quedan reservadas: usa una nueva para iniciar otra solicitud facturable. Sin esta cabecera, cada solicitud es independiente. Permite un timeout de 180 segundos.

Lista de revisión para migrar

1. Crea una clave en un plan con API. 2. Cambia el dominio y conserva /v1.0/removebg. 3. Revisa límites y parámetros no compatibles. 4. Prueba tus imágenes, errores y cobros. 5. Migra la producción. Este servicio es independiente de remove.bg.Ver guía de migración →

Una interfaz compatible no implica resultados de IA idénticos. Prueba tus imágenes antes de migrar.