Sieraden · Mogelijkheid

Sieraad Try-On API — Photta

Kettingen, ringen, armbanden en oorbellen geplaatst op close-up AI-modellen, geoptimaliseerd voor kleine, sterk reflecterende oppervlakken. Dezelfde 2K/4K prijsstelling als kleding, hetzelfde async-patroon.

In één zin

Photta's Sieraad Try-On API accepteert een sieraadfoto plus een `jewelry_type` (necklace, ring, bracelet of earrings) en retourneert een close-up foto op een model. POST naar `/api/v1/tryon/jewelry` met `Authorization: Bearer photta_live_xxx`, poll het geretourneerde ID elke 3 seconden en download het resultaat wanneer status verspringt naar `completed`.

Ontvang een API-sleutel→Lees de documentatie
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"
  }'

Wat je kunt verwachten

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Jewelry types

4

Close-up mannequins

built-in

Code, van begin tot eind

Kies je taal

Zelfde drie handleidingen — wissel het endpoint en de request body.

SDK

→

Node.js

Native fetch · vervang `/tryon/apparel` door `/tryon/jewelry` en je bent klaar

SDK

→

Python

requests + dezelfde photta.py wrapper · geen extra dependencies

SDK

→

cURL

Rooktest van twee minuten · perfect voor het verifiëren van sieraadtypes

Hoe het werkt

De kledingflow, geoptimaliseerd voor kleine, sterk reflecterende items

Kies een close-up mannequin, dien in, poll, download.

  1. 01

    Stap 1

    Genereer een API-sleutel

    Zelfde flow als kleding — ai.photta.app → Developers → Generate API key. Eén sleutel werkt voor elk endpoint; één credit-tegoed dekt elke mogelijkheid.

  2. 02

    Stap 2

    Kies een close-up mannequin

    Filter `/api/v1/mannequins?jewelry_type=necklace` (of ring / bracelet / earrings) — Photta beheert een speciaal gebouwde set close-up mannequins met huidtexturen die zijn afgestemd op kleine metalen en stenen.

  3. 03

    Stap 3

    POST de sieraad-taak

    POST naar `/api/v1/tryon/jewelry` met `jewelry_type`, `jewelry_images`, `mannequin_id`, `resolution`, `aspect_ratio`. De service schaalt de plaatsing automatisch voor de sieraad-categorie.

  4. 04

    Stap 4

    Poll tot de taak voltooid is

    Gebruik GET `/api/v1/tryon/jewelry/:id` elke 3 seconden. De structuur van de response is identiek aan kleding — `data.status`, `data.output_url`, `data.thumbnail_url`.

  5. 05

    Stap 5

    Downloaden en opslaan

    Een krappe 1:1 uitsnede werkt het best voor PDP-thumbnails; bredere beeldverhoudingen voor redactioneel gebruik. Sla de bytes zelf op in plaats van direct naar de CDN te linken.

Vragen die andere developers stellen

Vragen die developers stellen voordat ze sieraad try-on lanceren

Welke sieraadtypes worden ondersteund?+

Vier expliciete categorieën: necklace, ring, bracelet, earrings. Elke categorie heeft zijn eigen set speciaal gebouwde close-up mannequins en een plaatsings-heuristiek die is afgestemd op die vormfactor. Ringen en oorbellen profiteren het meest van een 1:1 beeldverhouding; kettingen komen goed tot hun recht bij 3:4.

Hoeveel kost een sieraad try-on?+

Hetzelfde als kleding: 5 credits bij 2K, 7 credits bij 4K. Mislukte taken worden automatisch terugbetaald. Geen extra kosten voor de close-up mannequin-bibliotheek.

Hoe verschilt het sieraad-endpoint van kleding?+

Dezelfde authenticatie, hetzelfde polling-patroon, dezelfde response-structuur — de verschillen zitten in de request body. Je stuurt `jewelry_type` en `jewelry_images` in plaats van `product_type` en `product_images`, en je kiest mannequins gefilterd op sieraad-categorie. Al het andere (2K/4K, beeldverhoudingen, credits) wordt gedeeld.

Kan ik mijn eigen sieraad-model uploaden?+

Ja — `/api/v1/jewelry-mannequins/upload` accepteert een aangepaste close-up referentie, `/api/v1/jewelry-mannequins/generate` produceert een nieuwe op basis van prompts. Beide retourneren een ID dat je weer gebruikt in het try-on verzoek.

Hoe gaat het om met reflecterende metalen en edelstenen?+

De close-up pipeline bevat metadata over spiegelende highlights en micro-geometrie. Goud, zilver en spiegelend platina worden correct gerenderd zonder de ghosting of chromatische vervaging die algemene try-on pipelines produceren. Ultra-schone studio-achtergronden worden aanbevolen voor de beste resultaten.

Hoe poll ik voor het resultaat?+

Gebruik GET `/api/v1/tryon/jewelry/:id` elke 3 tot 5 seconden. Dezelfde status-levenscyclus als kleding: `processing` → `completed` of `failed`. Een venster van 1.5 tot 4 minuten dekt de overgrote meerderheid van de taken.

Gerelateerd

Gerelateerde mogelijkheden

/api/virtual-try-on-api

virtual-try-on

5–7 credits · ~3 min

View capability →

Sieraden · Mogelijkheid

Maak een account aan en ontvang een API-sleutel

Photta's Sieraad Try-On API accepteert een sieraadfoto plus een `jewelry_type` (necklace, ring, bracelet of earrings) en retourneert een close-up foto op een model. POST naar `/api/v1/tryon/jewelry` met `Authorization: Bearer photta_live_xxx`, poll het geretourneerde ID elke 3 seconden en download het resultaat wanneer status verspringt naar `completed`.

Ontvang een API-sleutel →Bekijk prijzen
Sieraad Try-On API | Photta | Photta