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.
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
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.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.
Este servicio es independiente de remove.bg. Prueba el comportamiento, no solo los nombres de parámetros.