Guide · Ghost mannequin

Vad är ett ghost mannequin-API? bilden med osynlig docka

I en mening

Ett ghost mannequin-API tar ett foto av ett plagg på en docka och returnerar samma plagg med dockan borttagen och insidan rekonstruerad, så att plagget ser ut att behålla sin form på egen hand.

Hämta en API-nyckel Läs dokumentationen

Typisk tid: 1.5–4 min
Credits: 4 credits vid 2K · 5 credits vid 4K
Bearbetning: asynkron, polling

Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad 2026-09-10

Det korta svaret

Ghost mannequin-fotografering — även kallad osynlig docka eller hollow man — visar ett plagg som behåller sin form utan någon kropp inuti. Traditionellt sätts bilden ihop i efterbearbetningen från flera studiobilder: plagget på en docka, sedan dockan borttagen, och därefter kragens insida och muddar sammansatta i bilden igen.

Ett ghost mannequin-API gör detta i ett enda anrop. Du skickar in fotografiet på dockan, tjänsten tar bort formen och återskapar det som ska synas inuti plagget — kragens insida, muddarnas foder, linningen — och returnerar den färdiga bilden. Precis som med try-on är anropet asynkront: skicka, polla, ladda ner.

Det är standardbehandlingen på produktinformationssidor för kläder, så anropen kommer från katalogteam och marknadsplatser som behöver ett enhetligt utseende över tusentals artiklar utan att boka studiotid per plagg.

Endpointen som gör det

Hämtat direkt från Phottas API-dokumentation, inte skrivet för hand.

I korthet

Endpoint: POST /api/v1/ghost-mannequin
Autentisering: Bearer API-nyckel
Bearbetning: Asynkron — polla status-endpointen
Typisk tid: 1.5–4 min
Credits: 4 credits vid 2K · 5 credits vid 4K
Bildförhållanden: 3:4 · 1:1 · 4:3 · 9:16 · 16:9
Indatagränser: Upp till 10 MB per bild; JPEG, PNG, WebP
Idempotent: Nej

Vad du ska leta efter i ett ghost mannequin-API

Vad du skickar
Plagget fotograferat på en docka, plus en valfri baksidesvy. Photta accepterar JPEG, PNG och WebP upp till 10 MB per bild.
Vilken finish du får
Phottas endpoint tar en stil: 3d behåller plaggets tredimensionella volym, flat_lay plattar till det till en ren framåtvänd layout.
Vad det kostar
4 credits vid 2K och 5 vid 4K på Photta — en credit mindre än try-on på varje nivå, återbetalas automatiskt om ett jobb misslyckas.
Huruvida det har stöd för batchkörning
Katalogarbete anländer i klädställningar, inte enstaka plagg. Photta har en batch-endpoint som tar en array, reserverar credits i förväg och rapporterar status per artikel.

Det första anropet

Samma anrop i cURL, Node.js och 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"]

Frågor om ghost mannequin-API:er

Vad är ett ghost mannequin-foto?

En produktbild där plagget ser ut att sväva och behåller sin form utan synlig kropp eller galge. Den visar passform och invändig konstruktion samtidigt, vilket är anledningen till att den är standard på produktsidor för kläder.

Vad skickar jag till endpointen?

Ett fotografi av plagget på en docka. En baksidesvy är valfri och förbättrar rekonstruktionen när plagget är öppet eller vändbart.

Bör jag välja 3d eller flat lay?

3d när du vill att plagget ska uppfattas som buret — volym, axlar, ärmar. flat_lay när produktlistningen förväntar sig en enhetlig framåtvänd form, vilket marknadsplatser ofta gör.

Vad kostar en bild?

På Photta, 4 credits vid 2K och 5 vid 4K. I en batch reserveras samma pris per bild i förväg för hela körningen.

Kan jag köra en hel katalog?

Ja, via batch-endpointen. Batchstorlek och hur många batcher som kan köras samtidigt styrs båda av din plan, så en stor katalog körs som en sekvens av batcher.

Läs vidare

Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad 2026-09-10

Kör ett plagg genom det

Ett fotografi in, en bild med osynlig docka ut.

Skapa ett konto och hämta en API-nyckel Se endpoint

1.5–4 min
4 credits vid 2K · 5 credits vid 4K
asynkron, polling