Guide · Ghost Mannequin

Was ist eine Ghost-Mannequin-API? der Invisible-Mannequin-Shot

In aller Kürze

Eine Ghost-Mannequin-API nimmt ein Foto eines Kleidungsstücks auf einer Schneiderpuppe entgegen und gibt dasselbe Kleidungsstück ohne Puppe und mit rekonstruiertem Innenleben zurück, sodass das Teil seine eigene Form zu behalten scheint.

API-Key anfordern Dokumentation lesen

Typische Dauer: 1.5–4 min
Credits: 4 Credits bei 2K · 5 Credits bei 4K
Verarbeitung: asynchron, Polling

Jeder Zahlenwert auf dieser Seite stammt aus der Photta-API-Dokumentation · geprüft 2026-09-10

Die Kurzfassung

Ghost-Mannequin-Fotografie — auch Hollow Man oder unsichtbare Schaufensterpuppe genannt — zeigt ein Kleidungsstück formstabil ohne Körper darin. Traditionell wird dies in der Postproduktion aus mehreren Studioaufnahmen zusammengesetzt: das Kleidungsstück auf der Puppe, dann die Puppe entfernt, und anschließend werden Krageninnenseite und Manschetten wieder einmontiert.

Eine Ghost-Mannequin-API erledigt das in einem einzigen Aufruf. Sie senden das Foto auf der Puppe, der Dienst entfernt die Form, rekonstruiert das Innere des Kleidungsstücks — Halsausschnitt-Innenseite, Manschettenfutter, Bund — und gibt das fertige Bild zurück. Wie beim Try-on ist der Aufruf asynchron: absenden, pollen, herunterladen.

Es ist das Standard-Setup für Produktdetailseiten bei Bekleidung. Die Aufrufer sind daher Katalog-Teams und Marktplätze, die einen einheitlichen Look über Tausende von Artikeln hinweg benötigen, ohne Studiozeit pro Kleidungsstück zu buchen.

Der zuständige Endpoint

Direkt aus der Photta-API-Dokumentation bezogen, nicht manuell verfasst.

Auf einen Blick

Endpoint: POST /api/v1/ghost-mannequin
Authentifizierung: Bearer-API-Schlüssel
Verarbeitung: Asynchron — Polling über den Status-Endpoint
Typische Dauer: 1.5–4 min
Credits: 4 Credits bei 2K · 5 Credits bei 4K
Seitenverhältnisse: 3:4 · 1:1 · 4:3 · 9:16 · 16:9
Eingabelimits: Bis zu 10 MB pro Bild; JPEG, PNG, WebP
Idempotent: Nein

Worauf es bei einer Ghost-Mannequin-API ankommt

Was Sie senden
Das auf einer Puppe fotografierte Kleidungsstück plus eine optionale Rückansicht. Photta akzeptiert JPEG, PNG und WebP bis zu 10 MB pro Bild.
Welches Finish Sie erhalten
Phottas Endpoint akzeptiert einen Style: 3d behält das dreidimensionale Volumen des Kleidungsstücks bei, flat_lay reduziert es auf ein sauberes, flach liegendes Frontal-Layout.
Was es kostet
4 credits bei 2K und 5 bei 4K auf Photta — jeweils ein Credit weniger als Try-on pro Stufe, automatisch erstattet, wenn ein Job fehlschlägt.
Ob Batch-Verarbeitung unterstützt wird
Katalogarbeiten fallen ständerweise an, nicht einzeln. Photta bietet einen Batch-Endpoint, der ein Array entgegennimmt, die Credits im Voraus reserviert und den Status pro Element meldet.

Der erste Request

Derselbe Call in cURL, Node.js und 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"]

Fragen zu Ghost-Mannequin-APIs

Was ist ein Ghost-Mannequin-Foto?

Eine Produktaufnahme, bei der das Kleidungsstück frei zu schweben scheint und seine Form ohne sichtbaren Körper oder Kleiderbügel behält. Es zeigt Passform und Innenkonstruktion zugleich — weshalb es der Standard auf Bekleidungs-Produktseiten ist.

Was sende ich an den Endpoint?

Ein Foto des Kleidungsstücks auf einer Schaufensterpuppe. Eine Rückansicht ist optional und verbessert die Rekonstruktion bei offenen oder wendbaren Kleidungsstücken.

Sollte ich 3d oder Flat Lay wählen?

3d, wenn das Kleidungsstück wie getragen wirken soll — Volumen, Schultern, Ärmel. flat_lay, wenn das Listing eine einheitliche, flach ausgerichtete Frontalform verlangt, wie es Marktplätze oft tun.

Was kostet ein Bild?

Auf Photta 4 credits bei 2K und 5 bei 4K. Im Batch wird derselbe Preis pro Bild im Voraus für den gesamten Durchlauf reserviert.

Kann ich einen ganzen Katalog verarbeiten?

Ja, über den Batch-Endpoint. Die Batch-Größe und die Anzahl gleichzeitig laufender Batches richten sich nach Ihrem Tarif, sodass ein großer Katalog als Sequenz von Batches abgearbeitet wird.

Weiterlesen

Jeder Zahlenwert auf dieser Seite stammt aus der Photta-API-Dokumentation · geprüft 2026-09-10

Ein Kleidungsstück verarbeiten

Ein Foto rein, ein Invisible-Mannequin-Shot raus.

Konto erstellen und API-Key anfordern Zum Endpoint

1.5–4 min
4 Credits bei 2K · 5 Credits bei 4K
asynchron, Polling