Smykker · Funksjon

Jewelry Try-On API — Photta

Halskjeder, ringer, armbånd og øredobber plassert på nærbilder av AI-modeller, optimalisert for små og reflekterende overflater. Samme 2K/4K-prising som klær, samme asynkrone mønster.

Kort fortalt

Phottas API for smykkeprøving tar imot et bilde av et smykke pluss en `jewelry_type` (necklace, ring, bracelet eller earrings) og returnerer et modellbilde i nærbilde. POST til `/api/v1/tryon/jewelry` med `Authorization: Bearer photta_live_xxx`, poll den returnerte ID-en hvert 3 sekunder, og last ned resultatet når status blir `completed`.

Hent en API-nøkkel→Les dokumentasjonen
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"
  }'

Hva du kan forvente

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Jewelry types

4

Close-up mannequins

built-in

Kode, ende-til-ende

Velg ditt språk

Samme tre gjennomganger — bytt ut endepunktet og request-bodyen.

SDK

→

Node.js

Native fetch · bytt ut `/tryon/apparel` med `/tryon/jewelry` og du er klar

SDK

→

Python

requests + den samme photta.py-wrapperen · ingen ekstra avhengigheter

SDK

→

cURL

To-minutters smoke test · perfekt for å verifisere smykketyper

Slik fungerer det

Samme flyt som for klær, optimalisert for små, reflekterende gjenstander

Velg en nærbilde-mannequin, send inn, poll, last ned.

  1. 01

    Steg 1

    Generer en API-nøkkel

    Samme flyt som for klær — ai.photta.app → Developers → Generate API key. Én nøkkel fungerer på alle endepunkter; én kredittsaldo dekker alle funksjoner.

  2. 02

    Steg 2

    Velg en nærbilde-mannequin

    Filtrer `/api/v1/mannequins?jewelry_type=necklace` (eller ring / bracelet / earrings) — Photta tilbyr et sett med nærbilde-mannequiner med hudtekstur tilpasset metall og stein.

  3. 03

    Steg 3

    POST smykke-jobben

    POST til `/api/v1/tryon/jewelry` med `jewelry_type`, `jewelry_images`, `mannequin_id`, `resolution`, `aspect_ratio`. Tjenesten auto-skalerer plasseringen for smykkekategorien.

  4. 04

    Steg 4

    Poll til jobben er ferdig

    GET `/api/v1/tryon/jewelry/:id` hvert 3 sekunder. Responsen er identisk med klær — `data.status`, `data.output_url`, `data.thumbnail_url`.

  5. 05

    Steg 5

    Last ned og lagre

    Tett beskåret 1:1 fungerer best for produktside-miniatyrer; bredere formater for redaksjonelt innhold. Lagre filen selv i stedet for å hot-linke til CDN.

Spørsmål andre utviklere stiller

Spørsmål utviklere stiller før de lanserer smykkeprøving

Hvilke smykketyper støttes?+

Fire eksplisitte kategorier: necklace, ring, bracelet, earrings. Hver kategori har sitt eget sett med nærbilde-mannequiner og en plasseringslogikk tilpasset formfaktoren. Ringer og øredobber fungerer best i 1:1-format; halskjeder ser bra ut i 3:4.

Hvor mye koster en smykkeprøving?+

Samme som klær: 5 credits ved 2K, 7 credits ved 4K. Mislykkede jobber refunderes automatisk. Ingen ekstra kostnad for nærbilde-mannequinene.

Hvordan skiller smykke-endepunktet seg fra klær?+

Samme autentisering, polling-mønster og responstype — forskjellene ligger i request-bodyen. Du sender `jewelry_type` og `jewelry_images` i stedet for `product_type` og `product_images`, og du velger mannequiner filtrert på smykkekategori. Alt annet er felles.

Kan jeg laste opp min egen smykkemodell?+

Ja — `/api/v1/jewelry-mannequins/upload` tar imot en egendefinert referanse, og `/api/v1/jewelry-mannequins/generate` lager en ny fra tekstinstrukser. Begge returnerer en ID du bruker i prøve-forespørselen.

Hvordan håndteres reflekterende metaller og edelstener?+

Nærbilde-pipelinen håndterer metadata om lysreflekser og mikrogeometri. Gull, sølv og polert platina rendres korrekt uten de feilene som generelle modeller ofte lager. Rene studiobakgrunner anbefales for best resultat.

Hvordan poller jeg for resultatet?+

GET `/api/v1/tryon/jewelry/:id` hvert 3 til 5 sekunder. Samme statusforløp som klær: `processing` → `completed` eller `failed`. Et vindu på 1.5 to 4 minutes dekker de aller fleste jobber.

Relatert

Relaterte funksjoner

/api/virtual-try-on-api

virtual-try-on

5–7 credits · ~3 min

View capability →

Smykker · Funksjon

Opprett en konto og hent en API-nøkkel

Phottas API for smykkeprøving tar imot et bilde av et smykke pluss en `jewelry_type` (necklace, ring, bracelet eller earrings) og returnerer et modellbilde i nærbilde. POST til `/api/v1/tryon/jewelry` med `Authorization: Bearer photta_live_xxx`, poll den returnerte ID-en hvert 3 sekunder, og last ned resultatet når status blir `completed`.

Hent en API-nøkkel →Se priser
Jewelry Try-On API | Photta | Photta