Guía · Maniquí invisible

¿Qué es una API de ghost mannequin? la toma con maniquí invisible

En una frase

Una API de ghost mannequin toma una fotografía de una prenda en un maniquí y devuelve la misma prenda habiendo eliminado el maniquí y reconstruido su interior, de modo que la pieza parece mantener su propia forma.

Obtener una API key Leer la documentación

Tiempo típico: 1.5–4 min
Credits: 4 credits a 2K · 5 credits a 4K
Procesamiento: asíncrono, polling

Cada cifra de esta página proviene de la documentación de la API de Photta · verificado 2026-09-10

La respuesta corta

La fotografía con maniquí invisible — también llamada hollow man o ghost mannequin — muestra una prenda manteniendo su forma sin ningún cuerpo dentro. Tradicionalmente se compone en posproducción a partir de varias tomas de estudio: la prenda sobre un maniquí, luego la eliminación del maniquí y, por último, el montaje del interior del cuello y los puños.

Una API de maniquí invisible hace eso en una sola llamada. Envías la fotografía con el maniquí, el servicio elimina la figura y reconstruye lo que debería verse dentro de la prenda — el interior del escote, el forro de los puños, la cinturilla — y devuelve la imagen finalizada. Al igual que con el try-on, la llamada es asíncrona: enviar, polling, descargar.

Es el tratamiento estándar para las páginas de detalle de producto en moda, por lo que quienes la consumen son equipos de catálogo y marketplaces que necesitan una apariencia coherente en miles de artículos sin reservar horas de estudio por prenda.

El endpoint que lo hace

Leído de la documentación de la API de Photta, no escrito a mano.

De un vistazo

Endpoint: POST /api/v1/ghost-mannequin
Autenticación: Bearer API key
Procesamiento: Asíncrono — realiza polling al endpoint de estado
Tiempo típico: 1.5–4 min
Credits: 4 credits a 2K · 5 credits a 4K
Relaciones de aspecto: 3:4 · 1:1 · 4:3 · 9:16 · 16:9
Límites de entrada: Hasta 10 MB por imagen; JPEG, PNG, WebP
Idempotente: No

Qué buscar en una API de ghost mannequin

Qué envías
La prenda fotografiada sobre un maniquí, más una vista trasera opcional. Photta admite JPEG, PNG y WebP de hasta 10 MB por imagen.
Qué acabado obtienes
El endpoint de Photta admite un style: 3d mantiene el volumen tridimensional de la prenda, flat_lay la pliega en una disposición frontal limpia.
Cuánto cuesta
4 credits en 2K y 5 en 4K en Photta — un credit menos que try-on en cada nivel, reembolsado automáticamente si falla un trabajo.
Si admite procesamiento por lotes
El trabajo de catálogo llega en percheros, no por unidades sueltas. Photta cuenta con un endpoint por lotes que acepta un array, reserva los credits por adelantado y reporta el estado elemento por elemento.

La primera petición

La misma llamada en cURL, Node.js y Python.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/ghost-mannequin \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
  "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
  "image_side": "front",
  "angle": "side",
  "style": "3d",
  "background_color": "white",
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "user_instruction": "closed front, cream interior lining",
  "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

const res = await fetch("https://api.photta.app/api/v1/ghost-mannequin", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
    "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
    "image_side": "front",
    "angle": "side",
    "style": "3d",
    "background_color": "white",
    "resolution": "2K",
    "aspect_ratio": "3:4",
    "user_instruction": "closed front, cream interior lining",
    "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/ghost-mannequin",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
      "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
      "image_side": "front",
      "angle": "side",
      "style": "3d",
      "background_color": "white",
      "resolution": "2K",
      "aspect_ratio": "3:4",
      "user_instruction": "closed front, cream interior lining",
      "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

Preguntas sobre las API de ghost mannequin

¿Qué es una foto con maniquí invisible?

Una fotografía de producto donde la prenda parece flotar, manteniendo su forma sin cuerpo ni percha visibles. Muestra el ajuste y la confección interior a la vez, por lo que es la opción predeterminada en las páginas de producto de moda.

¿Qué le envío al endpoint?

Una fotografía de la prenda sobre un maniquí. La vista trasera es opcional y mejora la reconstrucción cuando la prenda es abierta o reversible.

¿Debería elegir 3d o flat lay?

3d cuando quieras que la prenda se perciba como puesta — volumen, hombros, mangas. flat_lay cuando la ficha de producto requiera una forma frontal uniforme, algo habitual en los marketplaces.

¿Cuánto cuesta una imagen?

En Photta, 4 credits en 2K y 5 en 4K. En un lote, el mismo precio por imagen se reserva por adelantado para toda la ejecución.

¿Puedo procesar un catálogo completo?

Sí, a través del endpoint por lotes. Tanto el tamaño del lote como la cantidad de lotes simultáneos dependen de tu plan, por lo que un catálogo grande se procesa como una secuencia de lotes.

Lectura recomendada

Cada cifra de esta página proviene de la documentación de la API de Photta · verificado 2026-09-10

Pasa una prenda a través de ella

Entra una fotografía, sale una toma con maniquí invisible.

Crear una cuenta y obtener una API key Ver el endpoint

1.5–4 min
4 credits a 2K · 5 credits a 4K
asíncrono, polling