Introducción
Qué hace este endpoint
Encuentra el objeto indicado en prompt y elimina todo lo demás, devolviendo un PNG con fondo transparente.
Entradas importantes
image_url es la foto y prompt describe el objeto que quieres conservar. autocrop ajusta el lienzo al objeto; refine_edges realiza una pasada adicional de limpieza de bordes. Ambas opciones están desactivadas por defecto.
Qué recibes
Un PNG transparente del tamaño de la foto, salvo que actives autocrop.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| Salida | Imagen |
| Endpoint | Edición de imagen |
| Lienzo | Tamaño completo de la foto o ajustado con autocrop |
| Limpieza de bordes | Pasada adicional opcional ( |
Funciones y aspectos destacados
Una de dos personas, elegida por su descripción
Pedimos "the woman in the cream sweater" en una escena de bar con dos personas. Regresó en un lienzo transparente de 1536×864, el tamaño completo, con los bordes del cabello y suéter intactos; se eliminaron el hombre y el estante de botellas.
Una sola copa de vino, con el recorte ajustado
Con autocrop activado, "the wine glass in front of the man" produjo un PNG de 130×307 solo con la copa. Las luces del bar visibles a través del cáliz quedaron en el recorte; tenlo en cuenta antes de colocar objetos de vidrio sobre otro fondo.
Sin dibujar máscaras
No hay que usar pinceles ni colocar recuadros. Una frase breve con un color, una posición o una prenda basta para distinguir elementos similares.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | La foto que contiene el objeto: archivo JPEG, PNG o WebP o enlace directo. Sin autocrop, el recorte conserva las dimensiones de esta foto. mínimo 1 caracteres |
prompt | Sí | Obligatorio. Describe brevemente el único objeto que quieres conservar, como "the red car" o "the woman in the cream sweater". mínimo 1 caracteres · máximo 500 caracteres |
refine_edges | No | Desactivado por defecto. Al activarlo, una pasada adicional de eliminación de fondo limpia píxeles residuales y transparencia de los bordes, útil en cabello y contornos suaves. Valor predeterminado: |
autocrop | No | Desactivado por defecto: devuelve el recorte al tamaño completo de la foto. Al activarlo, ajusta el lienzo al objeto. Valor predeterminado: |
Precios
$0.024 / imagen
Precio fijo por extracción; la descripción, limpieza de bordes y recorte no lo cambian. Las solicitudes fallidas no se cobran.
Casos de uso
Un producto entre muchos elementos
Extrae una botella, bolsa o zapato de una foto de ambiente para una ficha de catálogo, sin retocar a mano el resto de la escena.
Elige una persona de una foto grupal
Un eliminador de fondos conserva a todos en primer plano; aquí describes a quién conservar y los demás desaparecen junto con el fondo.
Recursos para collages y miniaturas
Ajusta el recorte al objeto y colócalo sobre un fondo nuevo, una miniatura de video o una diapositiva.
Guía de prompts y consejos prácticos
Describe un objeto
Escribe una frase nominal breve en prompt, como "the red car" o "the woman on the right". Agrega un color, posición o detalle de ropa si hay varios elementos similares.
Elige el lienzo
Deja autocrop desactivado para un recorte del tamaño completo de la foto, listo para volver a colocarlo en su posición. Actívalo para un PNG ajustado al objeto para una ficha de producto o calcomanía.
Limpia los bordes si hace falta
Activa
refine_edgespara una pasada adicional de eliminación de fondo que limpie píxeles sueltos y transparencia de los bordes, útil en cabello y contornos suaves.
Introducción
Object Extractor aísla un elemento de una foto a partir de una descripción y lo devuelve con fondo transparente. Un eliminador de fondos conserva todos los sujetos en primer plano; este endpoint conserva solo el objeto que nombras.
Solicitud
{
"image_url": "https://example.com/bar.jpg",
"prompt": "the woman in the cream sweater",
"refine_edges": true,
"autocrop": false
}
image_url y prompt son obligatorios. refine_edges agrega una pasada de eliminación de fondo para limpiar píxeles residuales de los bordes. autocrop ajusta el lienzo al objeto en lugar de conservar el tamaño completo de la foto.
Qué observamos en las pruebas
En una escena de bar de 1536×864, "the woman in the cream sweater" regresó sola a 1536×864 tras unos 17 segundos, con bordes limpios en cabello y suéter. Conservó la copa en la mano y una franja fina de la mesa en la que se apoyaba. Con autocrop activado, "the wine glass in front of the man" produjo un PNG de 130×307; el fondo visible a través del vidrio quedó dentro. Una taza sostenida con ambas manos regresó con huecos donde los dedos la tapaban. Una solicitud sin descripción devolvió la foto sin cambios.
Flujo de la tarea
La extracción es asíncrona. Crea la tarea, consulta su estado y, cuando esté lista, descarga el PNG transparente del almacenamiento de SpicyAPI. Cada extracción tiene precio fijo; las solicitudes fallidas no se cobran.
Consejos
- Sé específico si hay elementos similares: "the taller bottle on the left" funciona mejor que "the bottle".
- Deja
autocropdesactivado si quieres devolver el recorte a la misma posición después. - Para conservar todos los sujetos a la vez, Background Remover (
/models/background-remover-v1) es más sencillo.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/object-extractor-v1/edit",
"input": {
"image_url": "https://example.com/reference.png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.




