Opas · Ghost mannequin

Mikä on ghost mannequin -API? näkymätön mallinukke -kuva

Yhdellä lauseella

Ghost mannequin -API ottaa vastaan mallinuken päällä olevan vaatteen kuvan ja palauttaa saman vaatteen siten, että mallinukke on poistettu ja vaatteen sisäpuoli rekonstruoitu, jolloin vaatekappale näyttää säilyttävän muotonsa itsestään.

Hanki API-avain Lue dokumentaatio

Tyypillinen kesto: 1.5–4 min
Credits: 4 credits resoluutiolla 2K · 5 credits resoluutiolla 4K
Käsittely: asynkroninen, polling

Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu 2026-09-10

Lyhyt vastaus

Ghost mannequin -valokuvaus — jota kutsutaan myös nimillä hollow man tai invisible mannequin — näyttää vaatteen säilyttävän muotonsa ilman kehoa sen sisällä. Perinteisesti se yhdistetään jälkikäsittelyssä useista studiokuvista: vaate mallinuken päällä, sitten mallinukke poistettuna, ja lopuksi kauluksen ja hihansuiden sisäpuoli kompostoituna takaisin kuvaan.

Ghost mannequin -rajapinta tekee tämän yhdellä kutsulla. Lähetät valokuvan mallinukesta vaate yllään, palvelu poistaa nuken ja rekonstruoi sen, minkä tulisi näkyä vaatteen sisällä — kaula-aukon sisäosan, hihansuiden vuorin, vyötärönauhan — ja palauttaa valmiin kuvan. Kuten try-on-toiminnossa, kutsu on asynkroninen: lähetä, tee polling, lataa.

Se on vakiomuotoinen tuotesivujen käsittelytapa vaatteille, joten kutsujat ovat katalogitiimejä ja markkinapaikkoja, jotka tarvitsevat yhtenäisen ilmeen tuhansille tuotteille ilman vaatekohtaisen studioajan varaamista.

Tämän tekevä endpoint

Luettu suoraan Photta API -dokumentaatiosta, ei käsin kirjoitettu.

Lyhyesti

Endpoint: POST /api/v1/ghost-mannequin
Autentikointi: Bearer-API-avain
Käsittely: Asynkroninen — tee polling-kyselyitä status-endpointiin
Tyypillinen kesto: 1.5–4 min
Credits: 4 credits resoluutiolla 2K · 5 credits resoluutiolla 4K
Kuvasuhteet: 3:4 · 1:1 · 4:3 · 9:16 · 16:9
Syöterajoitukset: Enintään 10 MB per kuva; JPEG, PNG, WebP
Idempotentti: Ei

Mitä ottaa huomioon ghost mannequin -API:ssa

Mitä lähetät
Vaate kuvattuna mallinuken päällä sekä valinnainen takakuva. Photta hyväksyy JPEG-, PNG- ja WebP-tiedostot 10 MB kokoon asti kuvaa kohden.
Minkä viimeistelyn saat
Phottan endpoint ottaa vastaan tyylin: 3d säilyttää vaatteen kolmiulotteisen volyymin, flat_lay litistää sen siistiksi suoraan edestä kuvatuksi taitoksi.
Mitä se maksaa
4 credits tarkkuudella 2K ja 5 tarkkuudella 4K Phottassa — yksi credit vähemmän kuin try-on-toiminnossa kussakin tasossa, hyvitetään automaattisesti työn epäonnistuessa.
Tukeeko se eräajoa
Katalogityöt tulevat rekkitolkulla, eivät yksittäin. Phottalla on batch-endpoint, joka ottaa vastaan taulukon, varaa credits-yksiköt etukäteen ja raportoi tilan kohteittain.

Ensimmäinen pyyntö

Sama kutsu ympäristöissä cURL, Node.js ja 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"]

Kysymyksiä ghost mannequin -API:sta

Mikä on ghost mannequin -kuva?

Tuotekuva, jossa vaate näyttää leijuvan säilyttäen muotonsa ilman näkyvää kehoa tai vaateripustinta. Se näyttää istuvuuden ja sisärakenteen kerralla, minkä vuoksi se on oletusarvo vaatteiden tuotesivuilla.

Mitä lähetän endpointiin?

Valokuvan vaatteesta mallinuken päällä. Takakuva on valinnainen ja parantaa rekonstruktiota, kun vaate on avoin tai käännettävä.

Pitäisikö minun valita 3d vai flat lay?

3d, kun haluat vaatteen näyttävän päällä pidetyltä — volyymi, olkapäät, hihat. flat_lay, kun tuotelistauksessa odotetaan yhtenäistä suoraan edestä katsottua muotoa, mitä markkinapaikat usein edellyttävät.

Mitä yksi kuva maksaa?

Phottassa 4 credits tarkkuudella 2K ja 5 tarkkuudella 4K. Eräajossa sama kuvakohtainen hinta varataan etukäteen koko ajolle.

Voinko ajaa koko katalogin?

Kyllä, batch-endpointin kautta. Eräkoko ja samanaikaisesti ajettavien erien määrä määräytyvät tilauksesi mukaan, joten suuri katalogi ajetaan erien sarjana.

Lue seuraavaksi

Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu 2026-09-10

Aja yksi vaate sen läpi

Yksi valokuva sisään, yksi näkymätön mallinukke -kuva ulos.

Luo tili ja hanki API-avain Katso endpoint

1.5–4 min
4 credits resoluutiolla 2K · 5 credits resoluutiolla 4K
asynkroninen, polling