Korut · Ominaisuus

Jewelry Try-On API — Photta

Kaulakorut, sormukset, rannekorut ja korvakorut sijoitettuina lähikuviin AI-malleista. Optimuotu pienille heijastaville pinnoille. Sama 2K/4K-hinnoittelu ja asynkroninen malli.

Yhdellä lauseella

Phottan korusovitus-API hyväksyy korukuvan sekä `jewelry_type`-tiedon ja palauttaa lähikuvan mallin päällä. POST osoitteeseen `/api/v1/tryon/jewelry` otsakkeella `Authorization: Bearer photta_live_xxx`, pollata tunnusta 3 sekunnin välein ja lataa tulos, kun tila on `completed`.

Hanki API-avain→Lue dokumentaatio
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"
  }'

Mitä odottaa

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Jewelry types

4

Close-up mannequins

built-in

Koodi alusta loppuun

Valitse kieli

Samat kolme läpikäyntiä — vaihda vain päätepiste ja pyynnön runko.

SDK

→

Node.js

Natiivi fetch · vaihda `/tryon/apparel` osoitteeseen `/tryon/jewelry` ja olet valmis

SDK

→

Python

requests + sama photta.py-kääre · ei lisäriippuvuuksia

SDK

→

cURL

Kahden minuutin savutesti · täydellinen korutyyppien varmistamiseen

Miten se toimii

Sovitustyönkulku optimoituna pienille, heijastaville esineille

Valitse lähikuva-malli, lähetä, pollata, lataa.

  1. 01

    Vaihe 1

    Generoi API-avain

    Sama työnkulku kuin vaatteilla — ai.photta.app → Developers → Generate API key. Yksi avain toimii kaikissa päätepisteissä; yksi saldo kattaa kaikki ominaisuudet.

  2. 02

    Vaihe 2

    Valitse lähikuva-malli

    Suodata `/api/v1/mannequins?jewelry_type=necklace` (tai ring / bracelet / earrings) — Photta ylläpitää lähikuva-malleja, joiden ihon tekstuurit on optimoitu metallille ja kiville.

  3. 03

    Vaihe 3

    Lähetä korutehtävä

    POST osoitteeseen `/api/v1/tryon/jewelry` tiedoilla `jewelry_type`, `jewelry_images`, `mannequin_id`, `resolution`, `aspect_ratio`. Palvelu skaalaa sijoittelun automaattisesti koruluokan mukaan.

  4. 04

    Vaihe 4

    Pollata valmistumiseen asti

    GET `/api/v1/tryon/jewelry/:id` 3 sekunnin välein. Vastausmuoto on identtinen vaatteiden kanssa — `data.status`, `data.output_url`, `data.thumbnail_url`.

  5. 05

    Vaihe 5

    Lataa ja tallenna

    Tiukka 1:1 rajaus toimii parhaiten tuotesivujen pikkukuville; laajemmat kuvasuhteet sopivat editoriaaleihin. Tallenna tavut itse CDN-linkityksen sijaan.

Muiden kehittäjien kysymyksiä

Kysymyksiä kehittäjiltä ennen korusovituksen julkaisua

Mitä korutyyppejä tuetaan?+

Neljä luokkaa: necklace, ring, bracelet, earrings. Jokaisella on omat lähikuva-mallinsa ja sijoittelulogiikka, joka on optimoitu kyseiselle muodolle. Sormukset ja korvakorut hyötyvät 1:1-kuvasuhteesta; kaulakorut toimivat hyvin 3:4-suhteella.

Mitä korujen sovitus maksaa?+

Sama kuin vaatteilla: 5 krediittiä 2K-tarkkuudella, 7 krediittiä 4K-tarkkuudella. Epäonnistuneet työt hyvitetään automaattisesti. Lähikuva-kirjastosta ei peritä lisämaksua.

Miten koru-päätepiste eroaa vaatteista?+

Sama todennus, kyselymalli ja vastausmuoto — erot ovat pyynnön rungossa. Lähetät `jewelry_type` ja `jewelry_images` kenttien `product_type` ja `product_images` sijaan, ja valitset korusuodatetun mallin. Kaikki muu on jaettua.

Voinko ladata oman korumallini?+

Kyllä — `/api/v1/jewelry-mannequins/upload` hyväksyy oman referenssikuvan, `/api/v1/jewelry-mannequins/generate` luo uuden kehotteista. Molemmat palauttavat tunnuksen sovituspyyntöön.

Miten se käsittelee heijastavia metalleja ja jalokiviä?+

Lähikuva-putki sisältää metatietoa heijastuksista ja mikrogeometriasta. Kulta, hopea ja platina renderöityvät oikein ilman haamukuvia tai värivirheitä, joita yleiskäyttöiset putket saattavat tuottaa. Puhtaat studiotaustat ovat suositeltavia parhaaseen tulokseen.

Miten pollata tulosta?+

GET `/api/v1/tryon/jewelry/:id` 3–5 sekunnin välein. Sama tilakierto kuin vaatteilla: `processing` → `completed` tai `failed`. 1.5–4 minuutin ikkuna kattaa valtaosan tehtävistä.

Aiheeseen liittyvää

Liittyvät ominaisuudet

/api/virtual-try-on-api

virtual-try-on

5–7 credits · ~3 min

View capability →

Korut · Ominaisuus

Luo tili ja hanki API-avain

Phottan korusovitus-API hyväksyy korukuvan sekä `jewelry_type`-tiedon ja palauttaa lähikuvan mallin päällä. POST osoitteeseen `/api/v1/tryon/jewelry` otsakkeella `Authorization: Bearer photta_live_xxx`, pollata tunnusta 3 sekunnin välein ja lataa tulos, kun tila on `completed`.

Hanki API-avain →Katso hinnoittelu
Jewelry Try-On API | Photta | Photta