Przewodnik · Wirtualny try-on

Czym jest API do wirtualnego try-on? i co zwraca

W jednym zdaniu

API do wirtualnego try-on przyjmuje zdjęcie odzieży i zwraca obraz tej odzieży założonej przez modela. Wysyłasz POST ze zdjęciem, manekinem i pozą, odpytujesz o status zadania (polling), a następnie pobierasz wynik.

Pobierz klucz APIPrzeczytaj dokumentację
  • Typowy czas: 1.5–4 min
  • Credits: 5 credits w 2K · 6 credits w 4K
  • Przetwarzanie: asynchroniczne, polling

Każda liczba na tej stronie pochodzi z dokumentacji API Photta · sprawdzono

Krótka odpowiedź

API wirtualnego try-on to endpoint HTTP, który nakłada ubranie na modela. Przesyłasz zdjęcie produktu — zazwyczaj ujęcie na płasko lub na manekinie, które już posiadasz — a usługa zwraca zdjęcie tego ubrania nałożonego na modela. Bez studia, bez angażowania modeli, bez ponownych sesji przy zmianie wariantu kolorystycznego.

Wywołanie jest asynchroniczne, ponieważ renderowanie trwa dłużej, niż powinno czekać żądanie. Wysyłasz żądanie POST z ubraniem oraz wybranym modelem i pozą, API przyjmuje zadanie i zwraca id, a Ty odpytujesz endpoint statusu (polling), dopóki zadanie nie zgłosi ukończenia. Gotowy obraz jest zwracany jako adres URL, który pobierasz i zapisujesz we własnym zakresie.

Główni odbiorcy to zespoły zarządzające katalogami, które potrzebują zdjęć na modelach dla produktów niedostępnych w studiu, platformy marketplace otrzymujące od sprzedawców ujęcia na płasko oraz aplikacje pozwalające klientom zobaczyć ubranie na sylwetce innej niż standardowy model marki.

Endpoint, który to realizuje

Pobrane z dokumentacji API Photta, niepisane ręcznie.

W skrócie

Endpoint
POST /api/v1/tryon/apparel
Uwierzytelnianie
Klucz API Bearer
Przetwarzanie
Asynchroniczne — odpytuj endpoint statusu
Typowy czas
1.5–4 min
Credits
5 credits w 2K · 6 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 każdym API do try-on

  • Co przesyłasz

    Zdjęcie ubrania jako adres URL https lub data URI base64, a także wybrany model i pozę. Photta akceptuje formaty JPEG, PNG i WebP o rozmiarze do 10 MB na obraz.

  • Ile to trwa

    Na tyle długo, że operacja nie może być wykonana w ramach synchronicznego żądania webowego. Photta udostępnia typowy czas realizacji dla każdego endpointu i wymaga odpytywania co 3 sekundy — brak webhooków.

  • Ile to kosztuje

    Photta pobiera credits za każde wywołanie: 5 w rozdzielczości 2K i 6 w 4K dla try-on odzieży; są one potrącane w momencie rozpoczęcia zadania i automatycznie zwracane w przypadku niepowodzenia.

  • Jakie limity obowiązują

    Opublikowany rate limit wynosi 600 żądań na minutę na klucz, a w ramach poszczególnych planów obowiązuje limit jednoczesnego renderowania. Warto sprawdzić oba parametry przed przetwarzaniem całego katalogu.

Pierwsze żądanie

To samo wywołanie w cURL, Node.js i Python.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_type": "top",
  "product_images": [
    "https://cdn.yourstore.com/products/shirt-front.jpg"
  ],
  "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
  "product_category": "t_shirt",
  "mannequin_id": "mnk_f3a9b1",
  "pose_id": "pose_c2d4e5",
  "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
  "lock_background": true,
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "body_size": "M",
  "expression": "neutral",
  "user_instruction": "Keep the collar pattern crisp and centered."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

Pytania o API do wirtualnego try-on

Co zwraca API try-on?

Zdjęcie ubrania nałożonego na wybranego modela, dostarczane jako adres URL w ukończonym zadaniu. Pobierz je i zapisz — adres URL dostarczenia nie służy do trwałego hostingu.

Czy potrzebuję zdjęcia modela?

Nie. Photta dostarcza katalog manekinów do wyboru; możesz także wygenerować własnego modela na podstawie parametrów lub przesłać własnego. Zdjęcie ubrania to jedyny plik, który musisz dostarczyć.

Czym różni się to od wirtualnej przymierzalni?

Przymierzalnia to funkcjonalność skierowana bezpośrednio do klienta końcowego. API try-on to warstwa renderowania działająca w tle: jedno wywołanie na wejściu, jeden obraz na wyjściu. Możesz na nim zbudować przymierzalnię lub używać go wyłącznie do generowania zdjęć katalogowych.

Ile kosztuje wywołanie try-on?

W Photta jest to 5 credits w rozdzielczości 2K oraz 6 w 4K. W przypadku niepowodzenia zadania następuje zwrot, więc koszt ponowienia to wyłącznie koszt samej operacji ponownej.

Ile trwa generowanie jednego obrazu?

Endpoint udostępnia typowy czas realizacji, a samo zadanie raportuje swój status. Zamiast zakładać określony czas, odpytuj endpoint (polling) co 3 sekundy.

Czytaj dalej

Każda liczba na tej stronie pochodzi z dokumentacji API Photta · sprawdzono

Wypróbuj na własnym zdjęciu produktu

Jedno żądanie, jeden poll, jeden obraz.

Załóż konto i pobierz klucz APIZobacz endpoint
  • 1.5–4 min
  • 5 credits w 2K · 6 credits w 4K
  • asynchroniczne, polling