Smykker · Kapabilitet

Smykke Try-On API — Photta

Halskæder, ringe, armbånd og øreringe placeret på AI-modeller i nærbillede, med optimering til små, stærkt reflekterende overflader. Samme 2K/4K prissætning som tøj, samme asynkrone mønster.

Kort fortalt

Phottas smykke-try-on API accepterer et smykkebillede plus en `jewelry_type` (necklace, ring, bracelet eller earrings) og returnerer et on-model foto i nærbillede. POST til `/api/v1/tryon/jewelry` med `Authorization: Bearer photta_live_xxx`, polle det returnerede ID hvert 3 sekund, og download resultatet, når status skifter til `completed`.

Hent en API-nøgle→Læs dokumentationen
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"
  }'

Hvad kan man forvente

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Jewelry types

4

Close-up mannequins

built-in

Kode, ende-til-ende

Vælg dit sprog

Samme tre gennemgange — skift endpointet, skift request body.

SDK

→

Node.js

Native fetch · skift `/tryon/apparel` ud med `/tryon/jewelry` og du er klar

SDK

→

Python

requests + den samme photta.py wrapper · ingen ekstra afhængigheder

SDK

→

cURL

To-minutters smoke-test · perfekt til at verificere smykketyper

Sådan virker det

Tøj-flowet, optimeret til små, stærkt reflekterende genstande

Vælg en nærbillede-mannequin, indsend, polle, download.

  1. 01

    Trin 1

    Generer en API-nøgle

    Samme flow som tøj — ai.photta.app → Developers → Generate API key. Én nøgle virker på tværs af alle endpoints; én kreditsaldo dækker alle kapabiliteter.

  2. 02

    Trin 2

    Vælg en nærbillede-mannequin

    Filtrer `/api/v1/mannequins?jewelry_type=necklace` (eller ring / bracelet / earrings) — Photta vedligeholder et sæt specialbyggede nærbillede-mannequiner med hudteksturer optimeret til små metal- og stendele.

  3. 03

    Trin 3

    POST smykke-jobbet

    POST til `/api/v1/tryon/jewelry` med `jewelry_type`, `jewelry_images`, `mannequin_id`, `resolution`, `aspect_ratio`. Tjenesten auto-skalerer placeringen baseret på smykkekategorien.

  4. 04

    Trin 4

    Polle indtil jobbet er færdigt

    GET `/api/v1/tryon/jewelry/:id` hvert 3 sekund. Respons-strukturen er identisk med tøj — `data.status`, `data.output_url`, `data.thumbnail_url`.

  5. 05

    Trin 5

    Download og persistér

    Tæt beskæring i 1:1 fungerer bedst til PDP-thumbnails; bredere aspektforhold til redaktionelt indhold. Gem selv bytes i stedet for at hot-linke til CDN'et.

Spørgsmål fra andre udviklere

Spørgsmål udviklere stiller før implementering af try-on til smykker

Hvilke smykketyper understøttes?+

Fire eksplicitte kategorier: necklace, ring, bracelet, earrings. Hver kategori har sit eget sæt af specialbyggede nærbillede-mannequiner og en placerings-heuristik optimeret til netop den formfaktor. Ringe og øreringe fungerer bedst i 1:1 aspektforhold; halskæder ser godt ud i 3:4.

Hvad koster en smykke-try-on?+

Det samme som tøj: 5 credits ved 2K, 7 credits ved 4K. Fejlede jobs refunderes automatisk. Ingen ekstra gebyr for biblioteket af nærbillede-mannequiner.

Hvordan adskiller smykke-endpointet sig fra tøj?+

Samme autentificering, samme polling-mønster, samme respons-struktur — forskellene ligger i request body. Du sender `jewelry_type` og `jewelry_images` i stedet for `product_type` og `product_images`, og du vælger mannequiner filtreret efter smykkekategori. Alt andet (2K/4K, aspektforhold, credits) er fælles.

Kan jeg uploade min egen smykke-model?+

Ja — `/api/v1/jewelry-mannequins/upload` accepterer en brugerdefineret nærbillede-reference, `/api/v1/jewelry-mannequins/generate` producerer en ny ud fra prompts. Begge returnerer et ID, du sender tilbage i try-on requesten.

Hvordan håndteres reflekterende metaller og ædelsten?+

Nærbillede-pipelinen indeholder metadata om spejlrefleksioner og mikro-geometri. Guld, sølv og spejlpoleret platin renderes korrekt uden ghosting eller kromatiske fejl, som generelle try-on-pipelines kan producere. Ultra-rene studiebaggrunde anbefales for de bedste resultater.

Hvordan poller jeg for resultatet?+

GET `/api/v1/tryon/jewelry/:id` hvert 3 til 5 sekund. Samme status-livscyklus som tøj: `processing` → `completed` eller `failed`. Et vindue på 1.5 til 4 minutter dækker langt de fleste jobs.

Relateret

Relaterede kapabiliteter

/api/virtual-try-on-api

virtual-try-on

5–7 credits · ~3 min

View capability →

Smykker · Kapabilitet

Opret en konto og hent en API-nøgle

Phottas smykke-try-on API accepterer et smykkebillede plus en `jewelry_type` (necklace, ring, bracelet eller earrings) og returnerer et on-model foto i nærbillede. POST til `/api/v1/tryon/jewelry` med `Authorization: Bearer photta_live_xxx`, polle det returnerede ID hvert 3 sekund, og download resultatet, når status skifter til `completed`.

Hent en API-nøgle →Se priser
Smykke Try-On API | Photta | Photta