Maniquí invisible · Capacidad
API de Maniquí Invisible — Photta
Elimina el maniquí de una foto de prenda y mantén la construcción interior — costuras, forros, etiquetas — totalmente intacta. Acabado hollow-man o flat-lay, listo para lotes, 4 créditos en 2K.
En una frase
La API de maniquí invisible de Photta toma una foto de prenda sobre maniquí y devuelve una imagen de maniquí invisible con el interior de la prenda reconstruido. POST a `/api/v1/ghost-mannequin` con un `product_image_url`, un `style` (hollow_man o flat_lay) y una resolución. Sondea `/api/v1/ghost-mannequin/:id` cada 3 segundos hasta que el status cambie a `completed`.
curl -X POST https://ai.photta.app/api/v1/ghost-mannequin \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_image_url": "https://example.com/tshirt-on-model.jpg",
"style": "hollow_man",
"resolution": "2K"
}'Qué esperar
Typical completion
1–3min
2K / 4K credits
4 / 6
Styles
2
Batch-ready
yes
Código, de punta a punta
Elige tu lenguaje
Mismo contrato REST; el endpoint de maniquí invisible también soporta procesamiento por lotes para ejecuciones masivas de catálogos.
Cómo funciona
Una foto entra, una foto de maniquí invisible sale
Sube el origen, elige un estilo, envía, sondea, descarga.
- 01
Paso 1
Genera una API key
El maniquí invisible usa las mismas credenciales que cualquier otra capacidad de Photta — una clave, un saldo de créditos.
- 02
Paso 2
Sube la foto de origen
Puedes pasar una URL pública en `product_image_url` o subir los bytes primero vía `/api/v1/uploads`. El endpoint acepta JPG, PNG y WebP.
- 03
Paso 3
Envía el trabajo de maniquí invisible
POST a `/api/v1/ghost-mannequin` con `product_image_url`, `style` (hollow_man o flat_lay), `resolution`. Pasa un `webhook_url` si quieres un aviso cuando el trabajo termine — el polling sigue siendo la ruta principal.
- 04
Paso 4
Sondea hasta que el trabajo se complete
GET `/api/v1/ghost-mannequin/:id` cada 3 segundos. El maniquí invisible es más rápido que el try-on — usualmente de 1 a 3 minutos — porque no se está renderizando una persona nueva.
- 05
Paso 5
Descargar y persistir
El resultado es un PNG con el maniquí eliminado y el interior de la prenda reconstruido. Ideal para tomas fantasma de PDP, galerías de productos con sensación 3D e inserciones flat-lay.
Preguntas de otros desarrolladores
Preguntas que los desarrolladores hacen antes de implementar el maniquí invisible
¿Qué es la fotografía de maniquí invisible?+
Un tratamiento para PDP donde la prenda parece flotar en un cuerpo invisible, mostrando la forma y la construcción interior a la vez. Históricamente se compone de varias tomas de estudio; la API de Photta lo produce en una sola llamada a partir de una foto sobre maniquí.
¿Cuánto cuesta el maniquí invisible?+
4 créditos en 2K, 6 créditos en 4K — un crédito más barato en cada nivel que el try-on. Los trabajos fallidos se reembolsan automáticamente.
¿Cuál es la diferencia entre el estilo hollow-man y el flat-lay?+
Hollow-man mantiene la forma 3D del maniquí — la prenda conserva volumen, los hombros y las mangas se ven naturales y el interior se reconstruye. Flat-lay colapsa la prenda en una disposición 2D limpia, ideal para colecciones cápsula o listados de marketplace que esperan una forma frontal consistente.
¿Puedo procesar varias fotos por lotes?+
Sí. Haz un POST a `/api/v1/ghost-mannequin/batch` con un array de imágenes de origen. La respuesta te da un ID de lote más IDs de generación por cada ítem. Sondea `/api/v1/ghost-mannequin/batch/:id` para un estado agregado o cada ítem individualmente.
¿Preserva las costuras y etiquetas interiores?+
Sí — el modelo reconstruye el interior de la prenda (interior del cuello, interior de los puños, forro de la cintura) en lugar de alucinar una superficie genérica. Las etiquetas impresas o cosidas visibles en la foto original se mantienen siempre que sea posible.
¿Cómo realizo el polling para obtener el resultado?+
GET `/api/v1/ghost-mannequin/:id` cada 3 segundos. Los trabajos por lotes sondean un endpoint padre que devuelve un estado agregado más un desglose por ítem.
Maniquí invisible · Capacidad
Crea una cuenta y obtén una API key
La API de maniquí invisible de Photta toma una foto de prenda sobre maniquí y devuelve una imagen de maniquí invisible con el interior de la prenda reconstruido. POST a `/api/v1/ghost-mannequin` con un `product_image_url`, un `style` (hollow_man o flat_lay) y una resolución. Sondea `/api/v1/ghost-mannequin/:id` cada 3 segundos hasta que el status cambie a `completed`.