Odzież · Możliwość

Virtual Try-On API — Photta

Jedno wywołanie REST zamienia zdjęcie odzieży flat-lay w gotowy do kampanii obraz na modelu. Asynchroniczne, 1.5–4 minuty na generację, 5 credits przy 2K lub 7 credits przy 4K.

W jednym zdaniu

API wirtualnej przymierzalni Photta przyjmuje zdjęcie odzieży flat-lay, mannequin_id oraz pose_id, a następnie zwraca zdjęcie na modelu w 2K lub 4K. Uwierzytelniasz się za pomocą `Authorization: Bearer photta_live_xxx`, wysyłasz POST do `/api/v1/tryon/apparel`, odpytujesz ten sam endpoint ze zwróconym identyfikatorem co 3–5 sekund i pobierasz wynik, gdy status zmieni się na `completed`.

Pobierz klucz API→Przeczytaj dokumentację

POST/api/v1/tryon/apparel

cURL

curl -X POST https://ai.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_type": "dress",
    "product_images": ["https://example.com/dress.jpg"],
    "mannequin_id": "mnq_athena_ts",
    "pose_id": "pose_standing_front",
    "resolution": "2K",
    "aspect_ratio": "3:4"
  }'

Czego się spodziewać

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Aspect ratios

Product types

Kod, od początku do końca

Wybierz swój język

Ten sam endpoint, trzy gotowe poradniki. Każdy fragment kodu jest zgodny z oficjalną dokumentacją Photta.

SDK

→

Node.js

Natywny fetch w Node 18+ · gotowy na Next.js server actions

SDK

→

Python

requests + 30-liniowy wrapper · Django / FastAPI / Celery

SDK

→

cURL

Dwu-minutowy test powłoki · potoki jq · zero instalacji

Jak to działa

Cztery wywołania API, jedno zdjęcie produktu

Wybierz manekina i pozę, prześlij zadanie, odpytuj do zakończenia, pobierz wynik.

01
Krok 1
Wygeneruj klucz API
Zarejestruj się na ai.photta.app, otwórz zakładkę Developers, kliknij Generate API key. Klucze live zaczynają się od `photta_live_`. Umieść klucz w `PHOTTA_API_KEY` — nigdy go nie commituj.
02
Krok 2
Wybierz manekina i pozę
Użyj GET `/api/v1/mannequins` oraz `/api/v1/poses`, aby wyświetlić dostępne opcje. Wybierz identyfikatory pasujące do Twojej marki — rozmiar ciała, ekspresja, pochodzenie i kategoria pozy są możliwe do filtrowania.
03
Krok 3
Prześlij zadanie przymierzalni (POST)
Wyślij POST do `/api/v1/tryon/apparel` z `product_type`, `product_images`, `mannequin_id`, `pose_id`, `resolution`, `aspect_ratio`. API zwróci 202 Accepted wraz z identyfikatorem generacji.
04
Krok 4
Odpytuj do zakończenia zadania
Wywołuj GET `/api/v1/tryon/apparel/:id` co 3 sekundy. Gdy `data.status` zmieni się na `completed`, odpowiedź będzie zawierać `output_url` i `thumbnail_url`. Ustal górny limit prób, aby zawieszone zadanie nie blokowało Twojego zapytania.
05
Krok 5
Pobierz i zapisz
Pobierz bajty z `output_url` i zapisz je we własnym magazynie obiektowym. URL z CDN jest stabilny, ale Twój produkt nie powinien polegać na nim przy renderowaniu.

Pytania innych programistów

Pytania programistów przed wdrożeniem przymierzalni odzieży

Czym jest API wirtualnej przymierzalni Photta?+

To endpoint REST, który przyjmuje zdjęcie produktu flat-lay oraz parę identyfikatorów (manekin + poza) i zwraca fotorealistyczny obraz na modelu. Ten sam pipeline, co w aplikacji konsumenckiej Photta. Obsługiwanych jest sześć typów produktów: góra, dół, góra+dół, sukienka, jednoczęściowy strój, kombinezon.

Ile kosztuje jedno wywołanie?+

5 credits za wynik w 2K, 7 credits za 4K. Kredyty są dołączone do Twojej subskrypcji i mogą być uzupełniane. Nieudane generacje nie kosztują kredytów — są one zwracane.

Jak długo trwa generacja?+

Typowy czas realizacji to od 1.5 do 4 minut, mierzony end-to-end. POST zwraca identyfikator generacji w mniej niż sekundę; praca GPU odbywa się w tle podczas odpytywania.

Jakie typy produktów są obsługiwane?+

Sześć: `top`, `bottom`, `top_and_bottom`, `dress`, `one_piece`, `jumpsuit`. Każdy wymaga innej struktury `product_images` — na przykład `top_and_bottom` oczekuje adresów URL zarówno dla `top_image`, jak i `bottom_image`.

Czy mogę użyć własnego manekina?+

Tak. Prześlij zdjęcie manekina do `/api/v1/mannequins/upload` lub wygeneruj nowego modela AI za pomocą `/api/v1/mannequins/generate-model`. Zwrócony identyfikator można bezpośrednio użyć w zapytaniu o przymierzalnię.

Jak odpytywać o wynik?+

Wywołuj GET `/api/v1/tryon/apparel/:id` co 3 do 5 sekund, aż `data.status` przyjmie wartość `completed` lub `failed`. Ustal górny limit prób — 120 × 3s pokrywa udokumentowane okno czasowe z dużym zapasem.

Powiązane