Una solicitud HTTP familiar es el punto de partida. Usa esta lista para probar imágenes e integración antes de migrar la producción.
Nuestra API de producción está activa en Cloudflare. D1 reserva créditos de forma atómica, R2 privado guarda resultados para reintentos y Cloudflare Images solo se ejecuta para el posprocesamiento solicitado.
Lista de verificación de migración
1. Revisa las solicitudes que utilizas
Anota el método de entrada, formato de salida, tamaño y parámetros de edición. Se admiten archivos, URL HTTPS y base64 simple, pero no todas las opciones de remove.bg. Guarda las claves en el servidor y crea una nueva con un plan que incluya API.
2. Cambia el endpoint y la clave
Para solicitudes compatibles, conserva la estructura y cambia el origen y X-API-Key. Si una biblioteca fija el dominio de remove.bg, usa su opción de endpoint o un cliente HTTP directo. No envíes una clave de remove.bg a este servicio.
- POST https://api.remove.bg/v1.0/removebg + POST https://removebgtool.net/v1.0/removebg X-API-Key: YOUR_NEW_API_KEY
# Generate one ID per image; reuse it when retrying this request.
REQUEST_ID="$(uuidgen)"
curl --fail-with-body --max-time 180 \
-H 'X-API-Key: YOUR_API_KEY' \
-H "Idempotency-Key: $REQUEST_ID" \
-F 'image_file=@image.jpg' \
'https://removebgtool.net/v1.0/removebg' -o no-bg.png3. Compara los parámetros antes de probar
La compatibilidad se refiere al formato de solicitud, no a resultados idénticos. type debe ser auto, type_level none y channels rgba. Los parámetros no compatibles con valores no vacíos se rechazan, no se ignoran.
| Campo de solicitud | Compatibilidad aquí |
|---|---|
| image_file / image_url / image_file_b64 | Elige solo una entrada: image_file, image_url o image_file_b64. |
| format | auto, png, jpg o webp. ZIP no es compatible. |
| size | Los límites de píxeles dependen del formato. Revisa la tabla de tamaños y los límites de salida. |
| crop / bg_color | Se admiten crop=true/false y bg_color. |
| type / type_level / channels | Solo auto / none / rgba, respectivamente. |
| bg_image_url / shadow / roi / crop_margin / scale / position | No se admiten imágenes de fondo, sombras, ROI, márgenes de recorte, escala ni posición. |
4. Revisa las respuestas y la facturación
Lee Content-Type antes de guardar. Se devuelven bytes de imagen por defecto o JSON con result_b64 si lo solicitas. Revisa X-Credits-Charged y X-Request-ID. Las claves y créditos de remove.bg no se transfieren. Aquí, vista previa y resolución completa tienen el mismo cargo por imagen.
5. Prueba un conjunto representativo de imágenes
Prueba productos, retratos, bordes de poco contraste y cada formato, además de archivos grandes, claves inválidas, parámetros no compatibles y saldo insuficiente. Verifica 409, 429, timeouts y fallos de procesamiento. Conserva los ID para investigar errores.
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.
6. Cambia de forma gradual y conserva una opción de reversión
Envía primero una pequeña parte de tu carga a la nueva integración. Revisa éxito, calidad y créditos antes de aumentar el tráfico. Conserva la configuración anterior. El reparto de tráfico y la reversión dependen de tu aplicación, no de un interruptor automático del servicio.
Preguntas frecuentes sobre quitar fondos
¿Es un reemplazo directo de la API de remove.bg?
No. RemoveBG acepta image_file, image_url o image_file_b64, pero cambian los valores predeterminados y algunos parámetros de edición. Mapea cada campo y prueba la respuesta.
¿Puedo reutilizar mi clave API de remove.bg?
No. Crea una cuenta RemoveBG y genera otra clave en API Keys. No se importan cuentas, saldos ni claves anteriores.
¿Puedo enviar ahora solicitudes HD de pago?
Sí. La API de producción está activa. Crea una clave de RemoveBG, prueba los parámetros y resultados compatibles y cambia el tráfico de forma gradual.
RemoveBG es un servicio independiente y no está afiliado a remove.bg, Canva ni Leonardo.Ai. Las cuentas, los créditos y las claves API no se transfieren.