Jewelry · Capability

Jewelry Try-On API — Photta

Necklaces, rings, bracelets and earrings placed on close-up AI models, with handling tuned for tiny highly-reflective surfaces. Same 2K/4K pricing as apparel, same async pattern.

In one sentence

Photta's jewelry try-on API accepts a jewelry photo plus a `jewelry_type` (necklace, ring, bracelet or earrings) and returns a close-up on-model photo. POST to `/api/v1/tryon/jewelry` with `Authorization: Bearer photta_live_xxx`, poll the returned ID every 3 seconds, and download the result when status flips to `completed`.

Get an API key→Read the docs
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"
  }'

What to expect

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Jewelry types

4

Close-up mannequins

built-in

Code, end to end

Pick your language

Same three walkthroughs — swap the endpoint, swap the request body.

SDK

→

Node.js

Native fetch · swap `/tryon/apparel` for `/tryon/jewelry` and you're done

SDK

→

Python

requests + the same photta.py wrapper · no extra deps

SDK

→

cURL

Two-minute smoke test · perfect for verifying jewelry types

How it works

The apparel flow, retuned for small highly-reflective items

Pick a close-up mannequin, submit, poll, download.

  1. 01

    Step 1

    Generate an API key

    Same flow as apparel — ai.photta.app → Developers → Generate API key. One key works across every endpoint; one credit balance covers every capability.

  2. 02

    Step 2

    Pick a close-up mannequin

    Filter `/api/v1/mannequins?jewelry_type=necklace` (or ring / bracelet / earrings) — Photta maintains a purpose-built set of close-up mannequins with skin textures tuned for tiny metal and stone.

  3. 03

    Step 3

    POST the jewelry job

    POST to `/api/v1/tryon/jewelry` with `jewelry_type`, `jewelry_images`, `mannequin_id`, `resolution`, `aspect_ratio`. The service auto-scales placement for the jewelry category.

  4. 04

    Step 4

    Poll until the job completes

    GET `/api/v1/tryon/jewelry/:id` every 3 seconds. Response shape is identical to apparel — `data.status`, `data.output_url`, `data.thumbnail_url`.

  5. 05

    Step 5

    Download and persist

    Tight-crop 1:1 works best for PDP thumbnails; wider aspect ratios for editorial. Store the bytes yourself rather than hot-linking the CDN.

Questions other developers ask

Questions developers ask before shipping jewelry try-on

What jewelry types are supported?+

Four explicit categories: necklace, ring, bracelet, earrings. Each category has its own set of purpose-built close-up mannequins and a placement heuristic tuned to that form factor. Rings and earrings benefit most from 1:1 aspect ratio; necklaces read well at 3:4.

How much does a jewelry try-on cost?+

Same as apparel: 5 credits at 2K, 7 credits at 4K. Failed jobs refund automatically. No surcharge for the close-up mannequin library.

How is the jewelry endpoint different from apparel?+

Same authentication, same polling pattern, same response shape — the differences are in the request body. You send `jewelry_type` and `jewelry_images` instead of `product_type` and `product_images`, and you pick mannequins filtered by jewelry category. Everything else (2K/4K, aspect ratios, credits) is shared.

Can I upload my own jewelry model?+

Yes — `/api/v1/jewelry-mannequins/upload` accepts a custom close-up reference, `/api/v1/jewelry-mannequins/generate` produces a new one from prompts. Both return an ID you feed back into the try-on request.

How does it handle reflective metals and gemstones?+

The close-up pipeline carries metadata about specular highlights and micro-geometry. Gold, silver and mirror-polished platinum render correctly without the ghosting or chromatic smear that general-purpose try-on pipelines produce. Ultra-clean studio backgrounds are recommended for best results.

How do I poll for the result?+

GET `/api/v1/tryon/jewelry/:id` every 3 to 5 seconds. Same status lifecycle as apparel: `processing` → `completed` or `failed`. A 1.5 to 4 minute window covers the vast majority of jobs.

Related

Related capabilities

/api/virtual-try-on-api

virtual-try-on

5–7 credits · ~3 min

View capability →

Jewelry · Capability

Create an account and get an API key

Photta's jewelry try-on API accepts a jewelry photo plus a `jewelry_type` (necklace, ring, bracelet or earrings) and returns a close-up on-model photo. POST to `/api/v1/tryon/jewelry` with `Authorization: Bearer photta_live_xxx`, poll the returned ID every 3 seconds, and download the result when status flips to `completed`.

Get an API key →View pricing
Jewelry Try-On API | Photta | Photta