Smycken · Funktionalitet

Jewelry Try-On API — Photta

Halsband, ringar, armband och örhängen placerade på AI-modeller i närbild, med hantering optimerad för små högreflekterande ytor. Samma prissättning för 2K/4K som kläder, samma asynkrona mönster.

I en mening

Phottas API för provning av smycken accepterar ett foto på ett smycke plus en jewelry_type (halsband, ring, armband eller örhängen) och returnerar ett närbildsfoto på modell. Skicka POST till /api/v1/tryon/jewelry med Authorization: Bearer photta_live_xxx, polla det returnerade ID:t var 3:e sekund och ladda ner resultatet när status blir completed.

Hämta en API-nyckel→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"
  }'

Vad du kan förvänta dig

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Jewelry types

4

Close-up mannequins

built-in

Kod, hela vägen

Välj språk

Samma tre genomgångar — byt bara slutpunkt och request body.

SDK

→

Node.js

Inbyggd fetch · byt /tryon/apparel mot /tryon/jewelry så är du klar

SDK

→

Python

requests + samma photta.py-wrapper · inga extra beroenden

SDK

→

cURL

Två minuters smoke test · perfekt för att verifiera smyckestyper

Så fungerar det

Klädflödet, finjusterat för små högreflekterande föremål

Välj en närbildsmodell, skicka, polla, ladda ner.

  1. 01

    Steg 1

    Generera en API-nyckel

    Samma flöde som för kläder — ai.photta.app → Developers → Generate API key. En nyckel fungerar för alla slutpunkter; ett kreditsaldo täcker all funktionalitet.

  2. 02

    Steg 2

    Välj en närbildsmodell

    Filtrera /api/v1/mannequins?jewelry_type=necklace (eller ring / bracelet / earrings) — Photta tillhandahåller en uppsättning specialbyggda modeller för närbilder med hudtexturer anpassade för små metaller och stenar.

  3. 03

    Steg 3

    POST:a smyckesjobbet

    Skicka POST till /api/v1/tryon/jewelry med jewelry_type, jewelry_images, mannequin_id, resolution, aspect_ratio. Tjänsten auto-skalar placeringen för smyckeskategorin.

  4. 04

    Steg 4

    Polla tills jobbet är klart

    Använd GET /api/v1/tryon/jewelry/:id var 3:e sekund. Svarsformatet är identiskt med kläder — data.status, data.output_url, data.thumbnail_url.

  5. 05

    Steg 5

    Ladda ner och spara

    Tät beskärning i 1:1 fungerar bäst för PDP-thumbnails; bredare bildförhållanden för redaktionellt innehåll. Spara rådatan själv istället för att länka direkt till CDN.

Frågor från andra utvecklare

Frågor utvecklare ställer innan de lanserar provning av smycken

Vilka typer av smycken stöds?+

Fyra explicita kategorier: necklace, ring, bracelet, earrings. Varje kategori har sin egen uppsättning specialbyggda modeller för närbilder och en placeringsheuristik anpassad för den formfaktorn. Ringar och örhängen gör sig bäst i 1:1; halsband ser bra ut i 3:4.

Vad kostar en provning av smycken?+

Samma som kläder: 5 credits vid 2K, 7 credits vid 4K. Misslyckade jobb återbetalas automatiskt. Ingen extra kostnad för biblioteket med närbildsmodeller.

Hur skiljer sig slutpunkten för smycken från den för kläder?+

Samma autentisering, samma polling-mönster, samma svarsformat — skillnaderna finns i request body. Du skickar jewelry_type och jewelry_images istället för product_type och product_images, och du väljer modeller filtrerade efter smyckeskategori. Allt annat (2K/4K, bildförhållanden, credits) delas.

Kan jag ladda upp min egen smyckesmodell?+

Ja — /api/v1/jewelry-mannequins/upload tar emot en anpassad närbildsreferens, /api/v1/jewelry-mannequins/generate skapar en ny från prompts. Båda returnerar ett ID som du skickar med i provningsförfrågan.

Hur hanteras reflekterande metaller och ädelstenar?+

Närbilds-pipelinen innehåller metadata om spegelreflektioner och mikrogeometri. Guld, silver och spegelpolerad platina renderas korrekt utan den ghosting eller kromatisk oskärpa som generella provnings-pipelines kan ge. Ultrarena studiobakgrunder rekommenderas för bästa resultat.

Hur pollar jag efter resultatet?+

Använd GET /api/v1/tryon/jewelry/:id var 3:e till 5:e sekund. Samma statuslivscykel som kläder: processing → completed eller failed. Ett fönster på 1.5 till 4 minuter täcker de allra flesta jobb.

Relaterat

Relaterad funktionalitet

/api/virtual-try-on-api

virtual-try-on

5–7 credits · ~3 min

View capability →

Smycken · Funktionalitet

Skapa ett konto och hämta en API-nyckel

Phottas API för provning av smycken accepterar ett foto på ett smycke plus en jewelry_type (halsband, ring, armband eller örhängen) och returnerar ett närbildsfoto på modell. Skicka POST till /api/v1/tryon/jewelry med Authorization: Bearer photta_live_xxx, polla det returnerade ID:t var 3:e sekund och ladda ner resultatet när status blir completed.

Hämta en API-nyckel →Visa prissättning
Jewelry Try-On API | Photta | Photta