Biżuteria · Możliwość

Jewelry Try-On API — Photta

Naszyjniki, pierścionki, bransoletki i kolczyki umieszczone na modelach AI w zbliżeniu, z obsługą dostrojoną do małych, silnie odbijających powierzchni. Ten sam cennik 2K/4K co dla odzieży, ten sam asynchroniczny wzorzec.

W jednym zdaniu

API przymierzalni biżuterii Photta przyjmuje zdjęcie biżuterii oraz `jewelry_type` (naszyjnik, pierścionek, bransoletka lub kolczyki) i zwraca zdjęcie na modelu w zbliżeniu. Wyślij POST do `/api/v1/tryon/jewelry` z nagłówkiem `Authorization: Bearer photta_live_xxx`, odpytuj zwrócony identyfikator co 3 sekundy i pobierz wynik, gdy status zmieni się na `completed`.

Pobierz klucz API→Przeczytaj dokumentację
POST/api/v1/tryon/jewelry
cURL
curl -X POST https://ai.photta.app/api/v1/tryon/jewelry \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jewelry_type": "necklace",
    "jewelry_images": ["https://example.com/necklace.jpg"],
    "mannequin_id": "mnq_jewelry_close_01",
    "resolution": "2K",
    "aspect_ratio": "1:1"
  }'

Czego się spodziewać

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Jewelry types

4

Close-up mannequins

built-in

Kod, od początku do końca

Wybierz swój język

Te same trzy poradniki — zmień endpoint, zmień body zapytania.

SDK

→

Node.js

Natywny fetch · zamień `/tryon/apparel` na `/tryon/jewelry` i gotowe

SDK

→

Python

requests + ten sam wrapper photta.py · brak dodatkowych zależności

SDK

→

cURL

Dwu-minutowy smoke test · idealny do weryfikacji typów biżuterii

Jak to działa

Przepływ dla odzieży, zoptymalizowany dla małych, lśniących przedmiotów

Wybierz manekina do zbliżeń, wyślij, odpytuj, pobierz.

  1. 01

    Krok 1

    Wygeneruj klucz API

    Ten sam proces co przy odzieży — ai.photta.app → Developers → Generate API key. Jeden klucz działa we wszystkich endpointach; jedno saldo kredytowe pokrywa każdą funkcję.

  2. 02

    Krok 2

    Wybierz manekina do zbliżeń

    Filtruj `/api/v1/mannequins?jewelry_type=necklace` (lub ring / bracelet / earrings) — Photta oferuje dedykowany zestaw manekinów ze zbliżeniami i teksturą skóry zoptymalizowaną pod metal i kamienie.

  3. 03

    Krok 3

    Prześlij zadanie biżuterii (POST)

    Wyślij POST do `/api/v1/tryon/jewelry` z `jewelry_type`, `jewelry_images`, `mannequin_id`, `resolution`, `aspect_ratio`. Usługa automatycznie skaluje rozmieszczenie dla danej kategorii biżuterii.

  4. 04

    Krok 4

    Odpytuj do zakończenia zadania

    Wywołuj GET `/api/v1/tryon/jewelry/:id` co 3 sekundy. Struktura odpowiedzi jest identyczna jak w przypadku odzieży — `data.status`, `data.output_url`, `data.thumbnail_url`.

  5. 05

    Krok 5

    Pobierz i zapisz

    Ciasne kadrowanie 1:1 najlepiej sprawdza się jako miniatury na kartach produktów; szersze proporcje do materiałów edytorskich. Zapisuj bajty samodzielnie, zamiast linkować bezpośrednio do CDN.

Pytania innych programistów

Pytania programistów przed wdrożeniem przymierzalni biżuterii

Jakie typy biżuterii są obsługiwane?+

Cztery wyraźne kategorie: naszyjnik, pierścionek, bransoletka, kolczyki. Każda kategoria ma własny zestaw dedykowanych manekinów zbliżeniowych i heurystykę pozycjonowania dostrojoną do danego formatu. Pierścionki i kolczyki najlepiej wyglądają w proporcjach 1:1; naszyjniki dobrze prezentują się w 3:4.

Ile kosztuje przymierzalnia biżuterii?+

Tak samo jak odzież: 5 credits przy 2K, 7 credits przy 4K. Nieudane zadania są zwracane automatycznie. Brak dodatkowych opłat za bibliotekę manekinów zbliżeniowych.

Czym różni się endpoint biżuterii od odzieży?+

To samo uwierzytelnianie, ten sam wzorzec odpytywania, ta sama struktura odpowiedzi — różnice tkwią w body zapytania. Wysyłasz `jewelry_type` i `jewelry_images` zamiast `product_type` i `product_images` oraz wybierasz manekiny filtrowane po kategorii biżuterii. Cała reszta (2K/4K, proporcje, kredyty) jest wspólna.

Czy mogę przesłać własny model biżuterii?+

Tak — `/api/v1/jewelry-mannequins/upload` przyjmuje własne zdjęcie referencyjne zbliżenia, a `/api/v1/jewelry-mannequins/generate` tworzy nowe na podstawie promptów. Oba zwracają identyfikator do użycia w zapytaniu o przymierzalnię.

Jak radzi sobie z lśniącymi metalami i kamieniami szlachetnymi?+

Pipeline zbliżeniowy przenosi metadane o refleksach i mikro-geometrii. Złoto, srebro i polerowana platyna są renderowane poprawnie, bez efektu ghostingu czy rozmycia chromatycznego, które występują w ogólnych pipeline’ach przymierzalni. Dla najlepszych efektów zalecane są bardzo czyste tła studyjne.

Jak odpytywać o wynik?+

Wywołuj GET `/api/v1/tryon/jewelry/:id` co 3 do 5 sekund. Ten sam cykl życia statusu co przy odzieży: `processing` → `completed` lub `failed`. Okno czasowe 1.5 do 4 minut obejmuje zdecydowaną większość zadań.

Powiązane

Powiązane możliwości

/api/virtual-try-on-api

virtual-try-on

5–7 credits · ~3 min

View capability →

Biżuteria · Możliwość

Utwórz konto i pobierz klucz API

API przymierzalni biżuterii Photta przyjmuje zdjęcie biżuterii oraz `jewelry_type` (naszyjnik, pierścionek, bransoletka lub kolczyki) i zwraca zdjęcie na modelu w zbliżeniu. Wyślij POST do `/api/v1/tryon/jewelry` z nagłówkiem `Authorization: Bearer photta_live_xxx`, odpytuj zwrócony identyfikator co 3 sekundy i pobierz wynik, gdy status zmieni się na `completed`.

Pobierz klucz API →Zobacz cennik
Jewelry Try-On API | Photta | Photta