Perhiasan · Kapabilitas

API Virtual Try-On Perhiasan — Photta

Kalung, cincin, gelang, dan anting dipasang pada model AI close-up, dengan penanganan khusus untuk permukaan kecil yang sangat reflektif. Harga 2K/4K sama dengan pakaian, pola asinkron yang sama.

Dalam satu kalimat

API try-on perhiasan Photta menerima foto perhiasan plus `jewelry_type` (kalung, cincin, gelang, atau anting) dan mengembalikan foto model close-up. POST ke `/api/v1/tryon/jewelry` dengan `Authorization: Bearer photta_live_xxx`, poll ID yang dikembalikan setiap 3 detik, dan unduh hasil saat status berubah menjadi `completed`.

Dapatkan API key→Baca dokumentasi
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"
  }'

Apa yang diharapkan

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Jewelry types

4

Close-up mannequins

built-in

Kode, ujung ke ujung

Pilih bahasa Anda

Tiga panduan yang sama — cukup ganti endpoint dan request body.

SDK

→

Node.js

fetch bawaan · ganti `/tryon/apparel` dengan `/tryon/jewelry` dan selesai

SDK

→

Python

requests + wrapper photta.py yang sama · tanpa dependensi tambahan

SDK

→

cURL

Smoke test dua menit · sempurna untuk memverifikasi tipe perhiasan

Cara kerja

Alur pakaian, dioptimalkan untuk barang kecil yang sangat reflektif

Pilih manekin close-up, kirim, poll, unduh.

  1. 01

    Langkah 1

    Buat API key

    Alur yang sama dengan pakaian — ai.photta.app → Developers → Generate API key. Satu key berlaku untuk setiap endpoint; satu saldo kredit mencakup setiap kapabilitas.

  2. 02

    Langkah 2

    Pilih manekin close-up

    Filter `/api/v1/mannequins?jewelry_type=necklace` (atau cincin / gelang / anting) — Photta menyediakan set manekin close-up khusus dengan tekstur kulit yang dioptimalkan untuk logam dan batu mulia kecil.

  3. 03

    Langkah 3

    POST job perhiasan

    Kirim POST ke `/api/v1/tryon/jewelry` dengan `jewelry_type`, `jewelry_images`, `mannequin_id`, `resolution`, `aspect_ratio`. Layanan akan menskalakan penempatan secara otomatis sesuai kategori perhiasan.

  4. 04

    Langkah 4

    Poll hingga job selesai

    Panggil GET `/api/v1/tryon/jewelry/:id` setiap 3 detik. Struktur respons identik dengan pakaian — `data.status`, `data.output_url`, `data.thumbnail_url`.

  5. 05

    Langkah 5

    Unduh dan simpan

    Crop ketat 1:1 bekerja paling baik untuk thumbnail PDP; rasio aspek yang lebih lebar untuk editorial. Simpan byte sendiri daripada melakukan hot-linking ke CDN.

Pertanyaan pengembang lainnya

Pertanyaan pengembang sebelum deploy try-on perhiasan

Tipe perhiasan apa saja yang didukung?+

Empat kategori eksplisit: kalung, cincin, gelang, anting. Setiap kategori memiliki set manekin close-up khusus dan heuristik penempatan yang dioptimalkan. Cincin dan anting paling bagus dengan rasio aspek 1:1; kalung terlihat jelas pada 3:4.

Berapa biaya try-on perhiasan?+

Sama dengan pakaian: 5 kredit pada 2K, 7 kredit pada 4K. Job yang gagal dikembalikan otomatis. Tidak ada biaya tambahan untuk library manekin close-up.

Apa perbedaan endpoint perhiasan dengan pakaian?+

Autentikasi sama, pola polling sama, struktur respons sama — perbedaannya ada pada request body. Anda mengirim `jewelry_type` dan `jewelry_images` alih-alih `product_type` dan `product_images`, dan memilih manekin yang difilter berdasarkan kategori perhiasan. Selebihnya (2K/4K, rasio aspek, kredit) adalah sama.

Bisakah saya mengunggah model perhiasan saya sendiri?+

Ya — `/api/v1/jewelry-mannequins/upload` menerima referensi close-up kustom, `/api/v1/jewelry-mannequins/generate` menghasilkan yang baru dari prompt. Keduanya mengembalikan ID yang dimasukkan kembali ke request try-on.

Bagaimana cara menangani logam reflektif dan batu permata?+

Pipeline close-up membawa metadata tentang highlight spekular dan mikro-geometri. Emas, perak, dan platinum poles cermin dirender dengan benar tanpa ghosting atau chromatic smear seperti pada pipeline try-on umum. Latar belakang studio yang sangat bersih direkomendasikan untuk hasil terbaik.

Bagaimana cara polling untuk hasilnya?+

Panggil GET `/api/v1/tryon/jewelry/:id` setiap 3 hingga 5 detik. Siklus status sama dengan pakaian: `processing` → `completed` atau `failed`. Jendela waktu 1.5 hingga 4 menit mencakup sebagian besar job.

Terkait

Kapabilitas terkait

/api/virtual-try-on-api

virtual-try-on

5–7 credits · ~3 min

View capability →

Perhiasan · Kapabilitas

Buat akun dan dapatkan API key

API try-on perhiasan Photta menerima foto perhiasan plus `jewelry_type` (kalung, cincin, gelang, atau anting) dan mengembalikan foto model close-up. POST ke `/api/v1/tryon/jewelry` dengan `Authorization: Bearer photta_live_xxx`, poll ID yang dikembalikan setiap 3 detik, dan unduh hasil saat status berubah menjadi `completed`.

Dapatkan API key →Lihat harga
API Try-On Perhiasan | Photta | Photta