Handleiding · Ghost mannequin

Wat is een ghost mannequin API? de onzichtbare-paspop-foto

In één zin

Een ghost mannequin API neemt een foto van een kledingstuk op een paspop en retourneert hetzelfde kledingstuk met de paspop verwijderd en de binnenzijde gereconstrueerd, zodat het kledingstuk zijn eigen vorm lijkt te behouden.

API-sleutel ophalen Lees de documentatie

Typische duur: 1.5–4 min
Credits: 4 credits bij 2K · 5 credits bij 4K
Verwerking: async, polling

Elk getal op deze pagina is afkomstig uit de Photta-API-documentatie · gecontroleerd 2026-09-10

Het korte antwoord

Ghost mannequin-fotografie — ook wel hollow man of onzichtbare etalagepop genoemd — toont een kledingstuk dat zijn vorm behoudt zonder dat er een lichaam in zit. Traditioneel wordt dit in de nabewerking samengesteld uit meerdere studio-opnames: het kledingstuk op een etalagepop, vervolgens de pop verwijderd, en daarna de binnenkant van de kraag en manchetten er weer in gemonteerd.

Een ghost mannequin-API doet dat in één call. Je stuurt de foto op de etalagepop, de service verwijdert de vorm en reconstrueert wat zichtbaar moet zijn aan de binnenkant van het kledingstuk — de binnenzijde van de halslijn, de voering van de manchetten, de tailleband — en retourneert het voltooide beeld. Net als bij try-on is de call asynchroon: submit, poll, download.

Het is de standaard productdetailpagina-behandeling voor kleding, dus de callers zijn catalogusteams en marktplaatsen die een consistente uitstraling nodig hebben over duizenden artikelen zonder per kledingstuk studiotijd te boeken.

Het endpoint dat dit doet

Uitgelezen uit de Photta API-documentatie, niet handmatig geschreven.

In één oogopslag

Endpoint: POST /api/v1/ghost-mannequin
Authenticatie: Bearer API key
Verwerking: Asynchroon — poll het status-endpoint
Typische duur: 1.5–4 min
Credits: 4 credits bij 2K · 5 credits bij 4K
Beeldverhoudingen: 3:4 · 1:1 · 4:3 · 9:16 · 16:9
Invoerlimieten: Tot 10 MB per afbeelding; JPEG, PNG, WebP
Idempotent: Nee

Waarop te letten bij een ghost mannequin API

Wat je verstuurt
Het kledingstuk gefotografeerd op een etalagepop, plus een optioneel achteraanzicht. Photta accepteert JPEG, PNG en WebP tot 10 MB per afbeelding.
Welke afwerking je krijgt
Het endpoint van Photta accepteert een stijl: 3d behoudt het driedimensionale volume van het kledingstuk, flat_lay vlakt het af naar een strakke, frontale lay-out.
Wat het kost
4 credits bij 2K en 5 bij 4K op Photta — één credit minder dan try-on op elk niveau, automatisch terugbetaald wanneer een taak mislukt.
Of het in batches kan
Cataloguswerk arriveert per rek, niet per stuk. Photta heeft een batch-endpoint dat een array accepteert, de credits vooraf reserveert en de status per item rapporteert.

Het eerste request

Dezelfde call in cURL, Node.js en 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"]

Vragen over ghost mannequin API's

Wat is een ghost mannequin-foto?

Een productfoto waarop het kledingstuk lijkt te zweven en zijn vorm behoudt zonder zichtbaar lichaam of hanger. Het toont pasvorm en interne constructie tegelijk, vandaar dat het de standaard is op kledingproductpagina's.

Wat stuur ik naar het endpoint?

Een foto van het kledingstuk op een etalagepop. Een achteraanzicht is optioneel en verbetert de reconstructie wanneer het kledingstuk open of omkeerbaar is.

Moet ik kiezen voor 3d of flat lay?

3d wanneer je wilt dat het kledingstuk oogt als gedragen — volume, schouders, mouwen. flat_lay wanneer de listing een consistente, frontale vorm vereist, wat marktplaatsen vaak doen.

Wat kost één afbeelding?

Op Photta: 4 credits bij 2K en 5 bij 4K. In een batch wordt dezelfde prijs per afbeelding vooraf gereserveerd voor de gehele run.

Kan ik een hele catalogus verwerken?

Ja, via het batch-endpoint. Batchgrootte en het aantal batches dat gelijktijdig kan draaien zijn beide afhankelijk van je abonnement, dus een grote catalogus draait als een reeks opeenvolgende batches.

Lees verder

Elk getal op deze pagina is afkomstig uit de Photta-API-documentatie · gecontroleerd 2026-09-10

Haal één kledingstuk erdoorheen

Eén foto erin, één onzichtbare-paspop-foto eruit.

Maak een account aan en haal een API-sleutel op Bekijk het endpoint

1.5–4 min
4 credits bij 2K · 5 credits bij 4K
async, polling