Kapabilitet · Ghost mannequin

Ghost mannequin-API for hollow-man-produktbilder

I én setning

Phottas ghost mannequin-API tar et bilde av et plagg på en mannekeng og returnerer et usynlig mannekeng-bilde med plaggkonstruksjonens innside rekonstruert. Velg stilen 3d eller flat_lay, POST, poll hvert 3. sekund, last ned når jobben er fullført.

Få en API-nøkkel Les dokumentasjonen

Typisk tidsbruk: 1.5–4 min
Credits: 4 credits ved 2K · 5 credits ved 4K
Prosessering: asynkron, polling
Grenser: 600 forespørsler/min
Autentisering: Bearer-nøkkel

Hvert tall på denne siden er hentet fra dokumentasjonen for Photta-API-et · verifisert 2026-09-10

POST/api/v1/ghost-mannequin

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"]

A garment shown without its mannequin by the ghost mannequin API — Eksempel på respons

Kort oppsummert

Endepunkt: POST /api/v1/ghost-mannequin
Autentisering: Bearer API-nøkkel
Prosessering: Asynkron – poll status-endepunktet
Typisk tidsbruk: 1.5–4 min
Credits: 4 credits ved 2K · 5 credits ved 4K
Bildeformater: 3:4 · 1:1 · 4:3 · 9:16 · 16:9
Inndatagrenser: Opptil 10 MB per bilde; JPEG, PNG, WebP
Idempotent: Nei

Forespørsel og respons

Forespørsel

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"]

202 Accepted / completed

{
  "data": {
    "id": "gm_d4e5f6",
    "status": "processing",
    "style": "3d",
    "angle": "side",
    "background_color": "white",
    "resolution": "2K",
    "aspect_ratio": "3:4",
    "credits_used": 4,
    "created_at": "2026-04-10T16:00:00Z"
  },
  "request_id": "req_gm001"
}

{
  "data": {
    "id": "gm_d4e5f6",
    "status": "completed",
    "style": "3d",
    "angle": "side",
    "background_color": "white",
    "resolution": "2K",
    "aspect_ratio": "3:4",
    "output_url": "https://cdn.photta.app/generated/gm_d4e5f6.jpg",
    "thumbnail_url": "https://cdn.photta.app/generated/gm_d4e5f6-thumb.jpg",
    "credits_used": 4,
    "created_at": "2026-04-10T16:00:00Z",
    "completed_at": "2026-04-10T16:00:48Z",
    "duration_ms": 48000
  },
  "request_id": "req_gm002"
}

Forespørselsparametere

FeltBeskrivelse

product_image

Type: stringPåkrevd

URL or base64 data URI of the garment photo (front or back, on a mannequin or flat).

back_image

Type: string

URL or base64 data URI of the opposite side — helps the AI reconstruct the interior of the garment for a more realistic 3D effect.

image_side

Type: string

Which side product_image represents.

= front

frontback

angle

Type: string

Camera angle for the output. "side" is worth calling out: the side view is reconstructed from the front photo (plus the back photo when provided), giving you a third catalog view without a third photoshoot — and it works well even on textured garments (crochet, lace, embroidery).

= straight

straightbackside

style

Type: string

Output style: "3d" (ghost mannequin with 3D body shape) or "flat_lay" (garment laid flat, mannequin removed).

= 3d

3dflat_lay

background_color

Type: string

Background color.

= white

whitegraybeigeblack

resolution

Type: string

Output resolution. "2K" costs 4 credits per image; "4K" costs 5 credits per image. 4K is produced natively in a single generation — pick it upfront; the resolution cannot be changed after creation. Note: 4K cannot be combined with aspect_ratio 1:1 — that combination returns 400.

= 2K

2K4K

aspect_ratio

Type: string

Output aspect ratio. Note: 1:1 is not available at 4K resolution — 1:1 combined with 4K returns 400.

= 3:4

3:41:14:39:1616:9

user_instruction

Type: string

Optional free-form note, max 400 characters (anything longer is silently truncated). A guarded steer for ambiguous rendering choices — e.g. "closed front", "cream interior lining", "buttoned up" — it never overrides the source garment, brand label, or structural reconstruction, and it is explicitly NOT a determinism/seed control.

brand_label_id

Type: string

Brand label UUID returned by the Brand Labels API. Applied to the generated garment when present. API v1 request fields use snake_case; use brand_label_id.

Feil

StatusTypeBetydning

400invalid_request_error: The request is malformed or contains invalid parameters.
401authentication_error: The API key is missing, invalid, or expired.
402insufficient_credits_error: Your account does not have enough credits.
404not_found_error: The requested resource does not exist.
409conflict_error: The request conflicts with current state — e.g. your concurrent-batch cap is reached.
429rate_limit_error: Too many requests. Slow down and retry.Retry-After: 30
500api_error: An internal server error occurred. Retry later.

Grenser

600 forespørsler per minutt per API-nøkkel (Fast tidsvindu; grensen er lik for alle abonnementer)
En 429 inneholder Retry-After: 30 sekunder
Opptil 10 MB per bilde
Formater: JPEG, PNG, WebP
Samtidige batcher per abonnement: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
Kun polling – API-et sender ikke webhooks.

Ett bilde inn, ett invisible-mannequin-bilde ut

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

Trinn 1
Generer en API-nøkkel
Ghost mannequin bruker samme credentials som alle andre Photta-funksjoner — én nøkkel, én credit-saldo.
Trinn 2
Last opp kildebildet
Send en offentlig URL eller en base64 data-URI i `product_image`; legg til `back_image` hvis du har et bilde bakfra. JPEG, PNG og WebP opptil 10 MB per bilde.
Trinn 3
POST ghost mannequin-jobben
POST til `/api/v1/ghost-mannequin` med `product_image`, `style` (`3d` eller `flat_lay`) og valgfrie `angle`, `background_color`, `resolution`. Polling er det eneste fullføringssignalet — API-et sender ingen webhooks.
Trinn 4
Poll til jobben er fullført
GET `/api/v1/ghost-mannequin/:id` hvert 3. sekund til `data.status` er `completed` eller `failed`; typisk fullføringstid er 1.5 til 4 minutter.
Trinn 5
Last ned og behold
Outputen er en PNG der utstillingsdukken er fjernet og innsiden av plagget er rekonstruert. Ideelt for PDP ghost shots, produktgallerier med 3D-følelse og flat-lay-innstikk.

Samme endpoint i Node.js, Python og cURL

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

Hva er ghost mannequin-fotografering?

En PDP-behandling der plagget ser ut til å sveve på en usynlig kropp, og viser både fasong og innvendig konstruksjon samtidig. Historisk settes det sammen av flere studiobilder; Phottas API produserer det i ett enkelt kall fra ett bilde på utstillingsdukke.

Hvor mye koster ghost mannequin?

4 credits i 2K, 5 credits i 4K — én credit billigere på hvert nivå enn try-on. Feilede jobber refunderes automatisk.

Hva er forskjellen mellom 3D- og flat-lay-stil?

`3d`-stilen beholder dukkens tredimensjonale kroppsfasong — plagget beholder volum, skuldre og ermer oppleves naturlig, og innsiden rekonstrueres. `flat_lay` flater ut plagget til en ren 2D-oppstilling, ideelt for kapselkolleksjoner eller markedsplassoppføringer som krever en konsekvent fasong forfra.

Kan jeg batch-prosessere flere bilder?

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

Bevarer den innvendige sømmer og etiketter?

Ja — modellen rekonstruerer innsiden av plagget (innsiden av halskanten, mansjettene, fôret i linningen) i stedet for å hallusinere en generisk overflate. Merkelapper og trykte etiketter som er synlige på originalbildet beholdes når det er mulig.

Hvordan poller jeg etter resultatet?

GET `/api/v1/ghost-mannequin/:id` hvert 3. sekund. Batch-jobber poller et overordnet endpoint som returnerer en samlet status pluss en oppdeling per element.

Relaterte kapabiliteter

Hvert tall på denne siden er hentet fra dokumentasjonen for Photta-API-et · verifisert 2026-09-10

Prøv API-et på fem minutter

Generer en Photta API-nøkkel, lim inn cURL-kodesnutten ovenfor, og du har ditt første bilde på modell før kaffen er ferdig traktet.

Opprett en konto og få en API-nøkkel Les dokumentasjonen

1.5–4 min
4 credits ved 2K · 5 credits ved 4K
asynkron, polling
600 forespørsler/min
Bearer-nøkkel

Ghost mannequin-API for hollow-man-produktbilder

Kort oppsummert

Forespørsel og respons

Forespørselsparametere

Feil

Ett bilde inn, ett invisible-mannequin-bilde ut

Generer en API-nøkkel

Last opp kildebildet

POST ghost mannequin-jobben

Poll til jobben er fullført

Last ned og behold

Samme endpoint i Node.js, Python og cURL

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

Relaterte kapabiliteter

Prøv API-et på fem minutter