snipmat

Una sola solicitud POST. Sin procesos en segundo plano.

Elimina fondos de forma programática: resolución completa en todos los planes, precio fijo de 1 crédito por imagen sin importar el tamaño. Compatible de forma directa con la API estándar de la industria: apunta tu integración existente a snipmat.com y cambia la clave. ¿Vienes de remove.bg? Consulta la guía de migración y comparación.

Inicio rápido

Envía la imagen y recibe el recorte como cuerpo de la respuesta: sin sondeos, sin webhooks.

curl -X POST https://snipmat.com/api/v1.0/removebg \
  -H "X-Api-Key: sm_live_YOUR_KEY" \
  -F "image_file=@product.jpg" \
  -F "format=png" \
  -o product_nobg.png

Autenticación

Crea una clave en Configuración → Claves de API y envíala con cada solicitud como X-Api-Key (o Authorization: Bearer sm_live_…). Las claves se muestran una sola vez al crearlas y pueden revocarse al instante.

Parámetros

POST /api/v1.0/removebg como multipart, JSON o form-urlencoded.

Campo	Tipo	Descripción
image_file	archivo	La imagen (png/jpeg/webp, ≤25MB, ≤32MP). O usa image_url / image_file_b64.
image_url	string	URL pública desde la que obtener la imagen.
image_file_b64	string	Imagen codificada en Base64.
model	string	general = el mejor todo terreno, incl. personas/cabello, abre huecos cerrados automáticamente (predeterminado); dis = modelo alternativo BiRefNet-DIS — pruébalo solo si general no acierta con un producto, no para personas; lite = modelo más rápido y pequeño.
size	string	auto/full = resolución completa — gratis en todos los planes · preview = ≤0.25MP.
format	string	auto/png (transparente) · jpg · webp · zip (color.jpg + alpha.png).
channels	string	rgba (predeterminado) · alpha — devuelve solo la máscara como PNG en escala de grises.
bg_color	string	Color hexadecimal para colocar detrás del sujeto, p. ej. 81d4fa o #1e3a34ff.
bg_image_url	string	URL de una imagen para colocar detrás del sujeto.
crop	bool	Recorta el lienzo al cuadro delimitador del sujeto.
scale	string	Escala del sujeto como "80%" (10–100, se aplica con crop).
position	string	original (predeterminado) · center.
keep_largest	bool	Conserva solo el sujeto más grande, descartando manchas sueltas.

Créditos y cuenta

Cada llamada exitosa cuesta exactamente 1 crédito: una imagen de 32MP cuesta lo mismo que una miniatura. Eso equivale a menos de 2¢ por imagen en Pro y 4–9¢ en paquetes: servicios comparables cobran 20¢ o más. Las cuentas gratuitas incluyen 50 créditos/mes, Pro incluye 500, y los paquetes de créditos nunca caducan. Las llamadas fallidas se reembolsan automáticamente. Las imágenes procesadas también aparecen en tu historial web durante 30 días (90 en Pro) antes de eliminarse. Consulta tu saldo con GET /api/v1.0/account; cada respuesta también incluye los encabezados X-Credits-Monthly-Remaining y X-Credits-Balance.

Errores

Los errores se devuelven como: {"errors":[{"title":"...","code":"..."}]}

Estado	Código	Significado
400	missing_source / invalid_source	No se proporcionó imagen, o la URL/archivo no es una imagen compatible.
402	insufficient_credits	Tanto la asignación mensual como el saldo del paquete están vacíos.
403	auth_failed	Clave de API faltante, inválida o revocada.
413	image_too_large	Más de 25MB o 32 megapíxeles.
429	rate_limit_exceeded	Se alcanzó el límite de velocidad por clave: consulta X-RateLimit-Reset.
503	queue_saturated	Servicio ocupado: reintenta después de los segundos de Retry-After.

Límites de velocidad

30 solicitudes/minuto por clave en Free, 120 en Pro. Cada respuesta incluye X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset.

MCP para agentes de IA

Claude y otros clientes MCP pueden eliminar fondos directamente. Añade snipmat como conector con esta URL: verás una pantalla de inicio de sesión/consentimiento, sin necesidad de pegar claves:

https://snipmat.com/mcp

Conéctalo desde tu herramienta

1. Abre Configuración → Conectores (en claude.ai o en la aplicación de escritorio) y elige Añadir conector personalizado.
2. Nómbralo snipmat y pega https://snipmat.com/mcp.
3. Haz clic en Añadir y luego en Conectar: verás un inicio de sesión y consentimiento normal de snipmat. Eso es todo: pídele a Claude que elimine un fondo.

Cada cliente descubre el flujo OAuth automáticamente (registro dinámico + PKCE), sin pegar claves. Herramientas: remove_background, create_upload, start_batch, get_batch y check_quota. Los archivos locales funcionan de primera clase: create_upload devuelve URLs prefirmadas a las que el agente sube los bytes de la imagen mediante PUT: sin URL pública, sin hosts de terceros, sin base64 a través del modelo. Hasta 10 imágenes se procesan en una sola llamada a remove_background; conjuntos más grandes (hasta 100 en Pro) se ejecutan de forma asíncrona mediante sondeo con start_batch + get_batch. Para uso sin interfaz o en CI, omite OAuth y envía una clave de API en su lugar: Authorization: Bearer sm_live_… (en Claude Code: --header en el comando add). Revisa o revoca conexiones en cualquier momento en Configuración → Aplicaciones conectadas.

Documentación legible por máquina

¿Estás creando un agente o apuntando un LLM a snipmat? Todo lo de esta página está disponible como markdown plano (índice en /llms.txt), y la API HTTP como especificación OpenAPI 3.0.