Estado de tarea asíncrono
POST crea el trabajo. GET consulta queued, processing, succeeded o failed.
API de eliminación de fondo
Quita el fondo en tu producto, no en tu stack
Envía una URL de imagen pública, recibe un ID de tarea y consulta hasta que termine. Estándar y HD usan el mismo saldo de créditos que la web.
El acceso a la API requiere un plan de pago o una compra de créditos.
- Modo
- Asíncrono
- Créditos
- 1 / 2 por imagen
- Formatos
- PNG, WebP
Inicio rápido
curl -X POST 'https://bgly.net/api/v1/bg/removals' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"image_url":"https://example.com/photo.jpg","precision":"standard"}'De la clave API a la URL del recorte
La API es asíncrona: no hace falta mantener la conexión abierta mientras corre el modelo.
01
Crea una clave API
Inicia sesión, compra un plan o créditos y crea una clave en Ajustes → API Keys.
02
Envía una eliminación
Haz POST de image_url a /api/v1/bg/removals. subject, precision y output_format son opcionales.
03
Consulta el resultado
Haz GET del ID cada pocos segundos hasta succeeded y descarga output.url.
Capacidades de la API
Pensada para catálogos, fichas y pipelines
Un contrato versionado. Los detalles del proveedor quedan internos; tu app ve tareas, créditos y URLs de resultado.
Misma cartera de créditos
Estándar cuesta 1 crédito. HD (precision high) cuesta 2. Los fallos se reembolsan.
Sujeto y modos HD
Elige auto, product, portrait o hair, más precisión standard o high.
Reintentos seguros
Envía Idempotency-Key para que un reintento de red devuelva la tarea original en lugar de cobrar dos veces.
Qué automatizan los equipos con la API
El mismo flujo para un SKU o miles de fotos de ficha.
Catálogos de ecommerce
Limpia fotos de producto para Amazon, Shopify y anuncios sin estudio.
Pipelines por lotes
Coordina muchos trabajos independientes con IDs de tarea y creación idempotente.
Tu propio producto
Ofrece eliminación de fondo en editores, DAM o paneles de vendedores.
Precios de la API
Paga con los mismos créditos que la web
No hay un SKU aparte. Compra Lite, Pro o un pack y llama a la API con tu clave.
- Precisión estándar: 1 crédito por imagen.
- Precisión HD: 2 créditos por imagen.
- Las tareas fallidas devuelven los créditos reservados.
Límites actuales
La primera versión pública es URL de entrada y consulta de resultado. Diseña alrededor de estos límites.
- Solo URLs HTTP(S) públicas. Aún no hay subida multipart.
- Aún no hay webhooks. Consulta GET /api/v1/bg/removals/:id.
- El acceso requiere plan de pago o compra de créditos. Las URLs de resultado pueden caducar: descárgalas pronto.
Preguntas de la API
Respuestas prácticas para evaluar e integrar la API de bgly.
¿Listo para quitar fondos en tu producto?
Crea una cuenta, compra créditos y haz tu primera petición a la API en minutos.