Przewodnik · Ghost mannequin

Czym jest API ghost mannequin? zdjęcie typu invisible-mannequin

W jednym zdaniu

API ghost mannequin przyjmuje zdjęcie odzieży na manekinie i zwraca ten sam produkt z usuniętym manekinem oraz zrekonstruowanym wnętrzem, sprawiając, że ubranie zachowuje naturalną formę.

Pobierz klucz API Przeczytaj dokumentację

Typowy czas: 1.5–4 min
Credits: 4 credits w 2K · 5 credits w 4K
Przetwarzanie: asynchroniczne, polling

Każda liczba na tej stronie pochodzi z dokumentacji API Photta · sprawdzono 2026-09-10

W skrócie

Fotografia typu ghost mannequin — zwana także hollow man lub niewidzialnym manekinem — prezentuje odzież zachowującą swój kształt bez ciała wewnątrz. Tradycyjnie składa się ją w postprodukcji z kilku kadrów studyjnych: ubrania na manekinie, usunięcia manekina, a następnie wklejenia wnętrza kołnierza i mankietów.

API ghost mannequin robi to w jednym wywołaniu. Wysyłasz zdjęcie na manekinie, serwis usuwa jego formę, rekonstruuje to, co powinno być widoczne wewnątrz ubrania — wnętrze dekoltu, podszewkę mankietów, pas — i zwraca gotowy obraz. Podobnie jak przy try-on, wywołanie jest asynchroniczne: submit, poll, download.

To standardowy sposób prezentacji odzieży na stronach szczegółów produktu (PDP), dlatego odbiorcami są zespoły zarządzające katalogami i marketplace'y, które potrzebują spójnego wyglądu tysięcy produktów bez rezerwowania czasu w studiu na każdą sztukę.

Endpoint realizujący operację

Pobrane z dokumentacji API Photta, niepisane ręcznie.

W skrócie

Endpoint: POST /api/v1/ghost-mannequin
Uwierzytelnianie: Klucz API Bearer
Przetwarzanie: Asynchroniczne — odpytuj endpoint statusu
Typowy czas: 1.5–4 min
Credits: 4 credits w 2K · 5 credits w 4K
Proporcje obrazu: 3:4 · 1:1 · 4:3 · 9:16 · 16:9
Limity wejściowe: Do 10 MB na obraz; JPEG, PNG, WebP
Idempotentne: Nie

Na co zwracać uwagę w API ghost mannequin

Co wysyłasz
Ubranie sfotografowane na manekinie oraz opcjonalnie widok z tyłu. Photta obsługuje formaty JPEG, PNG i WebP do 10 MB na obraz.
Jakie wykończenie otrzymujesz
Endpoint Photta przyjmuje parametr style: 3d zachowuje trójwymiarową objętość ubrania, flat_lay spłaszcza je do czystego układu na płasko od przodu.
Ile to kosztuje
4 credits w 2K i 5 w 4K na Photta — o jeden credit mniej niż try-on na każdym poziomie, ze zwrotem automatycznym w przypadku błędu zadania.
Czy obsługuje przetwarzanie wsadowe
Prace katalogowe spływają seriami, a nie pojedynczo. Photta udostępnia endpoint wsadowy, który przyjmuje tablicę, rezerwuje credits z góry i raportuje status dla każdego elementu.

Pierwsze żądanie

To samo wywołanie w cURL, Node.js i 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"]

Pytania dotyczące API ghost mannequin

Czym jest zdjęcie ghost mannequin?

Zdjęciem produktowym, na którym odzież sprawia wrażenie zawieszonej w powietrzu, zachowując swój kształt bez widocznego ciała czy wieszaka. Pokazuje jednocześnie fason i konstrukcję wewnętrzną, dlatego jest domyślnym standardem na stronach produktów odzieżowych.

Co wysyłam do endpointu?

Zdjęcie ubrania na manekinie. Widok z tyłu jest opcjonalny i poprawia rekonstrukcję, gdy odzież jest rozpięta lub dwustronna.

Czy wybrać 3d czy flat lay?

3d, gdy chcesz, aby odzież wyglądała jak założona — z objętością, ramionami i rękawami. flat_lay, gdy listing wymaga jednolitego kształtu od przodu, czego często oczekują marketplace'y.

Ile kosztuje jeden obraz?

Na Photta: 4 credits w 2K i 5 w 4K. W przetwarzaniu wsadowym ta sama cena za obraz jest rezerwowana z góry dla całego zadania.

Czy mogę przetworzyć cały katalog?

Tak, za pośrednictwem endpointu wsadowego. Rozmiar partii oraz liczba jednocześnie uruchomionych zadań zależą od Twojego planu, więc duży katalog przetwarza się jako sekwencja partii.

Czytaj dalej

Każda liczba na tej stronie pochodzi z dokumentacji API Photta · sprawdzono 2026-09-10

Przetwórz jedno ubranie

Jedno zdjęcie na wejściu, jedno ujęcie typu invisible-mannequin na wyjściu.

Załóż konto i pobierz klucz API Zobacz endpoint

1.5–4 min
4 credits w 2K · 5 credits w 4K
asynchroniczne, polling