Introducción
Envía image_url para obtener un recorte PNG transparente a partir de una sola fotografía. Esta operación no ofrece campos de prompt, máscara ni calidad.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| Salida | Imagen |
| Identificador del modelo | ideogram/remove-background |
| Entrada por solicitud | Una fotografía |
| Parámetro público |
|
| Instrucción textual | Sin parámetro prompt |
| Salida por fotografía | Una imagen recortada |
| Formato entregado | PNG |
| Resultado del fondo | Transparente |
| Criterio de facturación | Cargo fijo por imagen completada |
| Solicitudes fallidas | No se cobran |
| Conservación del resultado | 14 días; después se elimina |
Funciones y aspectos destacados
Revisa la palanca además del timbre
La prueba del timbre de latón separó la pieza de la mesa de trabajo. El PNG transparente conservó los bordes de palanca y abrazadera, un ejemplo concreto de los contornos pequeños que revisar. Observa ese resultado para entender la prueba y comprueba los detalles equivalentes en tu producto antes de armar el catálogo.
Una URL inicia el recorte
Envía la foto mediante image_url sin redactar instrucciones ni dibujar máscaras. Cada foto completada tiene tarifa fija y devuelve un PNG transparente. La portada de piscina ilustra esa transición; es una ilustración, no una muestra de este endpoint. Para resultados medidos, revisa el timbre y el retrato rojo.
Un retrato de satén rojo con contornos limpios
Una foto de estudio de una mujer con vestido rojo de satén sin tirantes se convirtió en PNG transparente. El resultado observado tuvo bordes limpios en cabello y dobladillo. Revisa esas zonas del ejemplo y después tu retrato sobre fondos contrastantes. La evidencia corresponde a ese recorte de estudio y no promete lo mismo para todos los peinados, prendas o entornos.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | Aporta la URL de la fotografía de origen para eliminar su fondo; esta entrada obligatoria no tiene valor predeterminado y todas las fotos completadas usan la misma tarifa fija p… mínimo 1 caracteres |
Precios
$0.012 / imagen
La eliminación de fondo de Ideogram aplica un cargo fijo por imagen cuando se completa el recorte; el procesamiento sin resultado no se factura.
Casos de uso
Catálogos de piezas y accesorios
Prepara una foto de producto para un catálogo. El timbre de latón demuestra un recorte que conservó los bordes de palanca y abrazadera, detalles por revisar en objetos pequeños similares.
Diseños con retratos de moda
Separa la ropa fotografiada y a quien la lleva del fondo de estudio. El retrato de satén rojo devolvió límites limpios en cabello y dobladillo para revisar antes de colocarlo.
Gráficos de perfiles y ponentes
Usa un retrato transparente de una persona como capa de perfil o presentación de ponente. Elige una foto autorizada y añade nombre y fondo en el editor de diseño.
Variaciones de fondo para campañas
Reutiliza el PNG descargado sobre distintos colores o imágenes de campaña. El fondo se coloca en el diseño; guarda el recurso transparente junto a cada composición terminada.
Guía de prompts y consejos prácticos
Selecciona la fotografía fuente
Elige la foto cuyo sujeto necesitas como recurso independiente. Para personas, utiliza un retrato de un adulto que tengas derecho a usar y evita suplantaciones.
Envía su URL
Proporciona la fotografía mediante
image_url. Una descripción puede servir para preparar la fuente en otro lugar, pero este endpoint no recibe prompt ni máscara.Revisa el PNG recibido
Mira el recorte sobre fondos claros y oscuros en un editor. Comprueba contornos finos como cabello, dobladillos o piezas pequeñas antes de incorporarlo a un diseño.
Descarga y coloca el recorte
Guarda el PNG dentro del periodo de conservación de 14 días. Añade el fondo elegido en una composición aparte y conserva una copia transparente reutilizable.
Convierte una fotografía en un recorte reutilizable
Ideogram Remove Background separa el sujeto del entorno y devuelve un PNG transparente. Usa este endpoint de edición cuando ya tengas la fotografía y necesites su sujeto como recurso para un catálogo, retrato o campaña. Proporciona image_url; no hay una instrucción escrita que interpretar.
La fuente determina qué puede recortarse. Selecciona una foto con la persona o producto que quieras ubicar en otro lugar y revisa su contorno visible antes de enviarla. Si aparece una persona, utiliza una foto autorizada de un adulto sin suplantar a nadie.
Parámetro de solicitud
| Parámetro | Entrada obligatoria | Función |
|---|---|---|
image_url | URL de una fotografía fuente | Aporta la foto para eliminar el fondo |
Los parámetros públicos no incluyen prompt, máscara, calidad, formato de salida ni resolución. Los ajustes de un ejemplo de generación de imágenes no sirven para regular esta operación. Su resultado definido es PNG transparente: no necesitas solicitar transparencia en una frase.
En el ejemplo de satén rojo, image_url apunta a la fotografía de estudio proporcionada. La solicitud no describe vestido, peinado ni fondo en texto: ya estaban en la fuente.
Precio y conservación de la salida
La facturación aplica un cargo fijo por cada eliminación de fondo completada; una solicitud fallida no tiene cargo. Consulta el precio vigente en la página de Ideogram Remove Background antes de enviar fotos. El precio de otra herramienta o de una suscripción no establece la tarifa de este endpoint.
Descarga el PNG dentro de 14 días. Los resultados se eliminan al concluir ese periodo. Guarda el recorte junto a la foto de origen para que futuros cambios de diseño no dependan de conservar la salida alojada.
Cómo utilizar las descripciones para fotos fuente
No hay prompt que escribir para solicitar la eliminación. Los ejemplos de esta página son encargos para elegir, fotografiar o preparar la fuente en otro lugar. Describen ropa, ambiente, luz y entorno para planear la foto; envía la URL de la imagen resultante cuando esté lista.
Por ejemplo, describir a una mujer de unos treinta años con vestido de noche de satén puede orientar la foto de estudio. Añadir esa frase a una solicitud de recorte no aporta un control admitido. Un encargo de producto también puede especificar acabado de latón, ángulo de vista y luz suave de taller antes de fotografiarlo.
Al preparar las entradas:
- Mantén visibles en la foto las partes que necesitará la composición.
- Decide si necesitas una persona, producto u objeto concreto por nombre antes de elegir la operación.
- Para retratos, confirma el permiso de uso y utiliza sujetos adultos.
- Conserva la fuente para comparar sus detalles finos con el recorte.
Qué mostraron realmente los ejemplos
Timbre de bicicleta de latón
La prueba de la pieza devolvió un timbre de latón separado limpiamente. La palanca y la abrazadera mantuvieron sus bordes al eliminar la mesa de trabajo circundante. Son puntos de inspección útiles: compáralos con la fuente sin limitarte a la forma general del timbre.
Retrato de estudio con satén rojo
El ejemplo partió de una foto de estudio de una mujer con vestido sin tirantes. Devolvió PNG transparente con bordes limpios en cabello y dobladillo. La observación corresponde a esa foto y no demuestra el mismo resultado para cualquier peinado, tela o fondo.
La portada de piscina es una ilustración, sin constituir muestra generada ni otro resultado medido. Los dos recortes de ejemplo respaldan las observaciones descritas aquí.
Revisa el PNG antes de colocarlo
Abre el archivo descargado en un editor que muestre transparencia. Prueba debajo un fondo claro y otro oscuro y revisa cabello, dobladillos y contornos estrechos de las piezas a la escala de uso prevista. La cuadrícula es una ayuda de visualización: examina el PNG al decidir si sirve para el diseño.
El recorte transparente no incluye un fondo blanco nuevo ni otra escena. Añade el fondo en tu herramienta de composición y guarda una copia transparente junto a la exportación final. Así podrás reutilizar el recurso en distintos destinos sin tratar el reemplazo de fondo como un control de este endpoint.
Alcance y alternativas cercanas
La solicitud procesa una fotografía y devuelve un PNG transparente. No hay un campo público de texto para nombrar un objeto objetivo o pedir cambios en ropa, luz o entorno. Elige una fuente que ya tenga resueltas esas decisiones.
Background Remover V1 es otra opción para eliminar fondos. Selecciona Object Extractor V1 cuando quieras elegir un objeto concreto mediante una descripción escrita.
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": "ideogram/remove-background/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# 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.





