Gioielli · Funzionalità

API Prova Gioielli — Photta

Collane, anelli, bracciali e orecchini posizionati su modelli AI in close-up, con gestione ottimizzata per piccole superfici altamente riflettenti. Stessi prezzi 2K/4K dell'abbigliamento, stesso pattern asincrono.

In una frase

L'API di prova gioielli di Photta accetta la foto di un gioiello e un jewelry_type (necklace, ring, bracelet o earrings) e restituisce una foto in close-up su modella. POST su /api/v1/tryon/jewelry con Authorization: Bearer photta_live_xxx, polling dell'ID restituito ogni 3 secondi e download del risultato quando lo stato diventa completed.

Ottieni una API key→Leggi la documentazione
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"
  }'

Cosa aspettarsi

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Jewelry types

4

Close-up mannequins

built-in

Codice, end to end

Scegli il tuo linguaggio

Le stesse tre guide — cambia solo l'endpoint e il corpo della richiesta.

SDK

→

Node.js

fetch nativo · sostituisci /tryon/apparel con /tryon/jewelry ed è fatta

SDK

→

Python

requests + lo stesso wrapper photta.py · nessuna dipendenza extra

SDK

→

cURL

Smoke test di due minuti · ideale per verificare i tipi di gioielli

Come funziona

Il flusso dell'abbigliamento, ottimizzato per piccoli oggetti riflettenti

Scegli un manichino close-up, invia, polling, scarica.

  1. 01

    Step 1

    Genera una API key

    Stesso flusso dell'abbigliamento — ai.photta.app → Developers → Generate API key. Una sola chiave per tutti gli endpoint; un unico saldo crediti copre ogni funzionalità.

  2. 02

    Step 2

    Scegli un manichino close-up

    Filtra /api/v1/mannequins?jewelry_type=necklace (o ring / bracelet / earrings) — Photta mantiene un set specifico di manichini in close-up con texture della pelle ottimizzate per metalli e pietre.

  3. 03

    Step 3

    Invia il job gioielli tramite POST

    Invia una POST a /api/v1/tryon/jewelry con jewelry_type, jewelry_images, mannequin_id, resolution, aspect_ratio. Il servizio scala automaticamente il posizionamento per la categoria del gioiello.

  4. 04

    Step 4

    Esegui il polling fino al termine del job

    GET /api/v1/tryon/jewelry/:id ogni 3 secondi. La struttura della risposta è identica all'abbigliamento — data.status, data.output_url, data.thumbnail_url.

  5. 05

    Step 5

    Scarica e salva

    Il formato 1:1 con ritaglio stretto funziona meglio per le miniature delle schede prodotto; i formati più larghi per gli editoriali. Salva i byte direttamente invece di usare hot-link alla CDN.

Domande frequenti degli sviluppatori

Domande frequenti prima di integrare la prova gioielli

Quali tipi di gioielli sono supportati?+

Quattro categorie esplicite: necklace, ring, bracelet, earrings. Ogni categoria ha il suo set di manichini close-up e un'euristica di posizionamento ottimizzata per quel fattore di forma. Anelli e orecchini beneficiano del formato 1:1; le collane rendono meglio in 3:4.

Quanto costa una prova gioielli?+

Come per l'abbigliamento: 5 crediti a 2K, 7 crediti a 4K. I job falliti vengono rimborsati automaticamente. Nessun supplemento per l'accesso alla libreria di manichini close-up.

In cosa differisce l'endpoint gioielli da quello abbigliamento?+

Stessa autenticazione, stesso polling, stessa struttura di risposta — le differenze sono nel corpo della richiesta. Invii jewelry_type e jewelry_images invece di product_type e product_images, e scegli manichini filtrati per categoria gioielli. Tutto il resto (2K/4K, formati, crediti) è condiviso.

Posso caricare il mio modello per gioielli?+

Sì — /api/v1/jewelry-mannequins/upload accetta un riferimento custom per il close-up, /api/v1/jewelry-mannequins/generate ne produce uno nuovo tramite prompt. Entrambi restituiscono un ID da usare nella richiesta di prova.

Come vengono gestiti i metalli riflettenti e le pietre preziose?+

La pipeline close-up trasporta metadati su riflessi speculari e micro-geometria. Oro, argento e platino lucido vengono renderizzati correttamente senza gli effetti ghosting o le sbavature cromatiche tipiche delle pipeline generiche. Si raccomandano sfondi studio molto puliti per risultati ottimali.

Come effettuo il polling per il risultato?+

GET /api/v1/tryon/jewelry/:id ogni 3-5 secondi. Stesso ciclo di vita dell'abbigliamento: processing → completed o failed. Una finestra di 1.5–4 minuti copre la stragrande maggioranza dei job.

Correlati

Funzionalità correlate

/api/virtual-try-on-api

virtual-try-on

5–7 credits · ~3 min

View capability →

Gioielli · Funzionalità

Crea un account e ottieni una API key

L'API di prova gioielli di Photta accetta la foto di un gioiello e un jewelry_type (necklace, ring, bracelet o earrings) e restituisce una foto in close-up su modella. POST su /api/v1/tryon/jewelry con Authorization: Bearer photta_live_xxx, polling dell'ID restituito ogni 3 secondi e download del risultato quando lo stato diventa completed.

Ottieni una API key →Vedi i prezzi
API Prova Gioielli | Photta | Photta