851 Labs
851 Labs Background Remover
851-labs/background-remover
Modelo de procesamiento de imágenes especializado en el recorte automático, capaz de generar PNG transparentes o máscaras, ideal para eliminar el fondo de imágenes de productos de comercio electrónico y retratos en lote
Probar 851-labs/background-remover
Entrada
Creaciones
Ver todas las creacionesSalida
imagePrecios
851-labs/background-remover per image
| Precio unitario | $0.002 |
|---|
Descripción general
background-remover es un modelo de eliminación de fondos de imágenes de tarea única ofrecido por 851 Labs, al que se accede mediante la interfaz unificada de HiAPI.ai. El desarrollador envía una URL de imagen de acceso público y obtiene el resultado sin fondo, lo que lo hace adecuado para flujos automatizados que requieren un recorte de imágenes económico y rápido, como el preprocesamiento de material de comercio electrónico, avatares e imágenes de contenido. No asume tareas de generación ni edición; su propósito es realizar de forma sólida la separación limpia entre el primer plano y el fondo de una imagen.
Aspectos destacados
- Recorte ligero centrado en una sola tarea: solo elimina fondos, sin parámetros superfluos y con un bajo coste de integración, ideal para incorporarlo a canalizaciones de procesamiento de imágenes existentes.
- Envío directo por URL, una solicitud por imagen: la entrada solo requiere una dirección de imagen, con una estructura de llamada sencilla que facilita su integración en tareas por lotes y colas asíncronas.
- Procesamiento por lotes de bajo coste: la facturación es por imagen, adecuada para escenarios de limpieza de material que requieren grandes volúmenes de recortes repetitivos.
Descripción de capacidades
Eliminación automática de fondos: realiza la separación del primer plano en la imagen de entrada y devuelve directamente el resultado sin fondo, evitando el trazado manual y el ajuste de máscaras.
Entrada mediante URL de imagen remota: admite como única entrada una dirección de imagen de acceso público que comience por http o https, sin necesidad de subir archivos previamente, lo que facilita la conexión con servicios de alojamiento de imágenes y bibliotecas de material existentes.
Salida de una sola imagen, fácil de encadenar: cada llamada produce una imagen procesada que puede integrarse directamente como recurso intermedio en flujos posteriores de composición, maquetación o publicación.
Casos de uso
- Operaciones de comercio electrónico: eliminación de fondos en imágenes de productos: convierte las imágenes originales de productos en material de primer plano limpio, para publicarlas con un fondo uniforme o maquetar anuncios gráficos.
- Creadores de contenido: recorte de retratos y avatares: elimina el fondo de fotos de personas para producir material transparente listo para usarse en stickers, imágenes para redes sociales y páginas de perfil.
- Flujos de diseño: preprocesamiento de material: procesa las imágenes como capas sin fondo antes de la maquetación, reduciendo el tiempo de recorte manual como paso estandarizado de incorporación de material.
- Operaciones de plataforma: limpieza masiva de material: envía por lotes imágenes ya alojadas con URL en el servicio de alojamiento para obtener de forma uniforme versiones sin fondo destinadas a la exhibición de productos o contenido.
Limitaciones y recomendaciones de selección
Sus capacidades se limitan a la eliminación de fondos; no cuenta con generación de imágenes, repintado localizado ni edición compleja, por lo que para modificar imágenes de forma creativa conviene elegir otros modelos de imagen. La calidad de salida depende de la imagen de entrada; las imágenes en las que el sujeto y el fondo tienen colores similares o cuyos bordes presentan detalles complejos pueden requerir revisión manual. La llamada requiere proporcionar una URL de imagen de acceso público; los archivos locales o en redes privadas deben alojarse primero en una ubicación accesible. Si la tarea principal no es el recorte de imágenes, se recomienda usar un modelo con capacidades de generación o edición.
Preguntas frecuentes
Ver todas las preguntas →-
¿Es necesario escribir un prompt?
No. Solo necesitas proporcionar una URL de imagen; el modelo separará automáticamente el primer plano y el fondo.
-
¿La imagen de salida es realmente transparente?
La salida es un PNG con canal Alpha. El patrón de tablero de la página sirve para mostrar las zonas transparentes y no se incluye en el resultado original descargado.
-
¿Qué parámetros hay que pasar a la API?
Envía model e input.image_url. La URL de la imagen debe ser accesible directamente mediante HTTP o HTTPS.
-
¿Se puede ajustar el formato, el color o generar un nuevo fondo?
La interfaz actual se centra en la eliminación de fondos y no ofrece ajustes de formato, color de fondo ni configuración de prompts. Puedes pasar el resultado transparente a herramientas de edición posteriores para continuar el procesamiento.
Crear una tarea de generación
https://api.hiapi.ai/v1/tasks Encabezados
AuthorizationstringObligatorioClave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API
Content-TypestringOpcionalEl cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.
Idempotency-KeystringOpcionalClave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.
Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.
Cuerpo
modelstringObligatorioValor fijo actual: 851-labs/background-remover
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para 851-labs/background-remover y la ruta default; consulta la tabla de parámetros a continuación.
image_urlstringObligatoriominLength 1pattern ^https?://[^\s]+$Dirección de la imagen a procesar; debe ser una URL de imagen de acceso público. Este parámetro es la fuente de entrada para la eliminación del fondo; al proporcionarlo, el servicio recupera la imagen y devuelve el resultado con el fondo eliminado.
callbackobjectOpcional
Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.
Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.
urlstringObligatorioObligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.
whenstringOpcionalPredeterminado: "final"Actualmente solo se admite final: notifica tanto en success como en fail.
finalstoragestringOpcionalPredeterminado: "temp"Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.
temppersistentEjemplos de solicitud
# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "851-labs/background-remover",
"input": {
"image_url": "…"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "851-labs/background-remover",
input: {
"image_url": "…"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "851-labs/background-remover",
"input": {
"image_url": "…"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obtener el detalle de la tarea
https://api.hiapi.ai/v1/tasks/:id Campos de respuesta
taskIdstringObligatorioID de tarea, siempre con prefijo tk-hiapi-.
modelstringObligatorioNombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.
routestringOpcionalSolo aparece si se usó el parámetro route explícito; repite el valor enviado.
statusstringObligatorioEstado de la tarea.
queued En cola, sin iniciar.
handling Procesando.
archiving Proceso terminado, preparando artefactos.
success Terminal: completado, artefactos disponibles (se devuelve output).
fail Terminal: error (se devuelve error).
Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.
creatednumberObligatorioHora de creación de la tarea (segundos Unix).
completednumberObligatorioSegundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.
outputarrayOpcional
Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).
Array [ object ]
Elementos del array
urlstringObligatorioURL del artefacto, descargable directamente.
typestringObligatorioValores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.
expireAtnumberObligatorioSegundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.
errorobjectOpcional
Solo con status == fail.
codestringObligatorioCódigo de error de negocio.
messagestringObligatorioDescripción del error.
Ejemplos de respuesta
Éxito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} En proceso (no terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fallido
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artículos
Ver todos los artículos →-
Tutorial
Cómo llamar a kling-4.0/image-to-video en HiAPI: curl, Python y sondeo
-
Tutorial
Cómo llamar a hailuo-2.3-fast/image-to-video a través de la API de HiAPI: práctica con curl y Python
La primera solicitud ejecutable del nivel rápido y de bajo coste de imagen a vídeo: del ID del modelo a la descarga del MP4
-
Comparativa
Recraft v4.1 Flash comparativa horizontal de texto a imagen: guía de selección y migración para desarrolladores
Con un coste de $0.01 por imagen y capacidad pura de texto a imagen, evalúa si encaja en tu pipeline de generación de imágenes
-
Tutorial
Cómo llamar a hailuo-2.3/text-to-video mediante la API de HiAPI: curl, Python y ejemplos de solicitud ejecutables
-
Comparativa
hailuo-2.3-fast/image-to-video comparativa horizontal: cómo elegir un modelo de imagen a video y puntos clave para migrar
-
Tutorial
Uso de Kandinsky 6.0 Pro texto a video en HiAPI: tutorial con curl y Python
Demostración práctica centrada en la solicitud: construir la llamada de prompt a clip de video, enviar la solicitud, sondear el estado de finalización y descargar el resultado
-
Tutorial
Cómo usar kling-4.0/text-to-video a través de la API de HiAPI: curl, Python y un ejemplo de solicitud ejecutable
Guía práctica para desarrolladores: prompts cinematográficos, audio sincronizado, sondeo asíncrono y descarga de resultados
-
Tutorial
Tutorial de kandinsky-6.0-pro/image-to-video en HiAPI: curl + Python
Realiza una solicitud de imagen a video funcional en HiAPI: desde la carga del primer fotograma hasta el sondeo asíncrono y la descarga final
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
FLUX 1.1 Pro Black Forest Labs $0.050 /imagen -
FLUX.1 Fill Pro Black Forest Labs $0.071 /imagen -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /imagen -
FASHN Tryon v1.6 FASHN $0.107 /imagen -
Grok Imagine xAI $0.011 /segundo -
BRIA Eraser Bria $0.058 /imagen -
FLUX.1 Schnell Black Forest Labs $0.005 /imagen -
Grok Imagine Quality xAI $0.070 /imagen -
Nano Banana 2 Google $0.036 /imagen -
GPT Image 2 OpenAI $0.007 /imagen -
Qwen Image 2.0 Alibaba $0.042 /imagen -
Seedream 4.5 ByteDance $0.045 /imagen







