Ghost Mannequin · Funksjon

Ghost Mannequin API — Photta

Fjern utstillingsdukken fra et klesbilde og behold innvendig konstruksjon — sømmer, fôr, merkelapper — helt intakt. Hollow-man- eller flat-lay-finish, batch-klar, 4 credits ved 2K.

Kort fortalt

Phottas ghost mannequin-API tar et bilde av klær på en mannequin og returnerer et bilde med usynlig mannequin der innsiden av plagget er rekonstruert. POST til `/api/v1/ghost-mannequin` med en `product_image_url`, en `style` (hollow_man eller flat_lay), og en oppløsning. Poll `/api/v1/ghost-mannequin/:id` hvert 3 sekunder til status blir `completed`.

Hent en API-nøkkel→Les dokumentasjonen

POST/api/v1/ghost-mannequin

cURL

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"
  }'

Hva du kan forvente

Typical completion

1–3min

2K / 4K credits

4 / 6

Styles

Batch-ready

yes

Kode, ende-til-ende

Velg ditt språk

Samme REST-kontrakt; ghost mannequin-endepunktet støtter også batch-prosessering for store varekataloger.

SDK

→

Node.js

Native fetch · fungerer sømløst med BullMQ eller Inngest for batch-jobber

SDK

→

Python

requests + asyncio når du trenger parallell innsending

SDK

→

cURL

Ideelt for smoke-testing av batch-data før full integrasjon

Slik fungerer det

Ett bilde inn, ett bilde med usynlig mannequin ut

Last opp kilden, velg stil, send inn, poll, last ned.

01
Steg 1
Generer en API-nøkkel
Ghost mannequin bruker samme legitimasjon som alle andre Photta-funksjoner — én nøkkel, én saldo.
02
Steg 2
Last opp kildebildet
Du kan sende en offentlig URL i `product_image_url` eller laste opp filen først via `/api/v1/uploads`. Endepunktet godtar JPG, PNG og WebP.
03
Steg 3
POST ghost mannequin-jobben
POST til `/api/v1/ghost-mannequin` med `product_image_url`, `style` (hollow_man eller flat_lay), `resolution`. Send med `webhook_url` hvis du vil ha et varsel når jobben er ferdig — polling fungerer fortsatt som primærmetode.
04
Steg 4
Poll til jobben er ferdig
GET `/api/v1/ghost-mannequin/:id` hvert 3 sekunder. Ghost mannequin er raskere enn virtuell prøving — vanligvis 1 to 3 minutes — fordi ingen ny person rendres.
05
Steg 5
Last ned og lagre
Utdata er en PNG der utstillingsdukken er fjernet og innsiden av plagget er rekonstruert. Ideelt for produktsider, 3D-aktige gallerier og flat-lay-innstikk.

Spørsmål andre utviklere stiller

Spørsmål utviklere stiller før de lanserer ghost mannequin

Hva er ghost mannequin-fotografering?+

En metode for produktsider der plagget ser ut til å sveve på en usynlig kropp, slik at både form og innvendig konstruksjon vises. Tradisjonelt settes dette sammen av flere studiobilder; Phottas API lager det i ett kall fra ett bilde på mannequin.

Hvor mye koster ghost mannequin?+

4 credits ved 2K, 6 credits ved 4K — én kreditt billigere per nivå enn virtuell prøving. Mislykkede jobber refunderes automatisk.

Hva er forskjellen mellom hollow-man og flat-lay?+

Hollow-man beholder 3D-formen til mannequinen — plagget beholder volum, skuldre og ermer ser naturlige ut, og innsiden rekonstrueres. Flat-lay flater ut plagget til et rent 2D-oppsett, ideelt for kolleksjoner eller markedsplasser som krever en konsistent form forfra.

Kan jeg batch-prosessere flere bilder?+

Ja. Send en POST til `/api/v1/ghost-mannequin/batch` med en array av kildebilder. Responsen gir deg en batch-ID pluss genererings-ID-er per element. Poll `/api/v1/ghost-mannequin/batch/:id` for samlet status eller hvert element individuelt.

Bevarer det innvendige sømmer og etiketter?+

Ja — modellen rekonstruerer innsiden av plagget (halsåpning, mansjetter, linning) i stedet for å lage en generisk overflate. Merkelapper og trykte etiketter som er synlige på originalbildet, beholdes der det er mulig.

Hvordan poller jeg for resultatet?+

GET `/api/v1/ghost-mannequin/:id` hvert 3 sekunder. Batch-jobber poller et overordnet endepunkt som returnerer samlet status pluss detaljer per element.

Relatert