API de bgCut.net

Elimine fondos desde sus propias aplicaciones, tiendas o flujos de trabajo con una sola solicitud HTTPS.

URL base: https://bgcut.net/api/v1 · Obtenga su clave en Claves de API.

Autenticación

Cada solicitud debe incluir su clave de API en el encabezado X-Api-Key. Las claves se crean y revocan en su cuenta; puede asignar un nombre a cada clave para rotarlas por aplicación.

X-Api-Key: bgc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

También puede enviarla como token Bearer: Authorization: Bearer bgc_…

POST /remove

Envíe la imagen como archivo multipart, como URL o codificada en base64. De forma predeterminada, la respuesta es la imagen resultante (binaria).

Parámetros

ParámetroTipoDescripción
image_filefileEl archivo de imagen (multipart/form-data). JPG, PNG, WebP, GIF, BMP, TIFF; máx. 25 MB / 30 MP.
image_urlstringURL pública de la imagen que se descargará en lugar de subirla.
image_file_b64stringImagen codificada en base64 (opcionalmente con el prefijo data:).
sizeauto | preview | fullpreview = hasta 640 px (usa su cuota mensual gratuita, sin créditos); full = resolución original (1 crédito); auto (predeterminado) = full si tiene créditos; de lo contrario, preview.
formatpng | jpg | webpFormato de salida. png conserva la transparencia; jpg se aplana sobre bg_color (blanco por defecto).
modelfast | hq | portraitfast (predeterminado, ~1 s), hq (mayor calidad, más lento), portrait (optimizado para personas).
bg_colorstringColor hexadecimal del fondo, p. ej., #ffffff. Omítalo para obtener un fondo transparente.
bg_blurnumberConserva el fondo original, pero lo desenfoca con este radio en píxeles (1–200), p. ej., 25 para un efecto de modo retrato. Anula bg_color.
cropbooleanRecorta la salida al cuadro delimitador del sujeto.
crop_marginintegerMargen adicional en píxeles alrededor del sujeto al recortar (0–200).
roistringRegión de interés como fracciones x,y,w,h (0–1). La IA solo analiza el interior de este rectángulo; todo lo exterior se vuelve transparente.
feathernumberSuaviza los bordes con este radio en píxeles (0–5).
qualityintegerCalidad JPG/WebP de 50 a 100 (92 por defecto).
responsebinary | jsonbinary (predeterminado) devuelve la imagen; json devuelve los metadatos junto con la imagen en base64.

Respuestas

Las solicitudes correctas devuelven HTTP 200 con los bytes de la imagen y estos encabezados:

HTTP/1.1 200 OK
Content-Type: image/png
X-Credits-Charged: 1
X-Credits-Remaining: 149
X-Free-Remaining: 5
X-Width: 3000
X-Height: 2000
X-Image-Id: 1f3a…
X-Type: hd

Con response=json obtiene:

{
  "ok": true,
  "image": { "id": "1f3a…", "width": 3000, "height": 2000, "format": "png", "type": "hd", "bytes": 812345, "bbox": [120, 40, 2810, 1990], "data": "iVBORw0KGgo…" },
  "credits_charged": 1,
  "credits_remaining": 149,
  "free_remaining": 5
}

GET /account

curl https://bgcut.net/api/v1/account -H "X-Api-Key: bgc_…"

{ "ok": true, "email": "[email protected]", "credits": 149, "free_remaining": 5, "free_per_month": 5, "free_max_width": 640, "rate_limit_per_minute": 60 }

GET /images

Devuelve las últimas 100 imágenes procesadas con sus claves de API, incluida una URL del editor para retocarlas en el navegador.

Errores

Los errores se devuelven en JSON con un código de error y un mensaje legible:

{ "ok": false, "error": "insufficient_credits", "message": "No credits left. Buy credits at https://bgcut.net/pricing or request size=preview." }
HTTPerrorDescripción
400bad_request / missing_imageFaltan parámetros o no son válidos.
401auth_required / invalid_keyClave de API ausente, no válida o revocada.
402insufficient_credits / free_quota_exceededSin créditos (para tamaño completo) o cuota gratuita agotada (para vista previa).
422too_large / bad_type / fetch_failedNo se pudo leer ni descargar la imagen.
429rate_limitedDemasiadas solicitudes: reduzca el ritmo o contáctenos para obtener límites más altos.
500processing_failedEl procesamiento falló por nuestra parte; no se le cobrará.

Código de ejemplo

Todos los ejemplos usan el mismo endpoint. Descargue la colección completa de ejemplos: bgcut-api-examples.zip

Límites

  • 60 solicitudes por minuto por clave de API (límites más altos bajo petición).
  • Máximo 25 MB y 30 megapíxeles por imagen; las imágenes más grandes se reducen.
  • Las imágenes procesadas se conservan durante 30 días y pueden retocarse en el editor web.
  • Las solicitudes fallidas nunca se cobran; si falla la generación del resultado, el cargo se reembolsa automáticamente.

Empiece a integrar

Cree una cuenta gratuita, genere una clave y haga su primera llamada en menos de un minuto.

Obtener clave de API Precios