Takı · Yetenek

Takı Deneme API'si — Photta

Kolye, yüzük, bilezik ve küpeler, küçük ve yansıtıcı yüzeyler için optimize edilmiş yakın çekim yapay zeka modellerine yerleştirilir. Giyim ile aynı 2K/4K fiyatlandırması ve asenkron desen.

Tek cümlede

Photta'nın takı deneme API'si bir takı fotoğrafı ve bir `jewelry_type` (kolye, yüzük, bilezik veya küpe) kabul eder ve model üzerinde yakın çekim bir fotoğraf döndürür. `Authorization: Bearer photta_live_xxx` ile `/api/v1/tryon/jewelry` adresine POST yapın, dönen ID'yi her 3 saniyede bir poll edin ve durum `completed` olduğunda sonucu indirin.

API anahtarı alın→Dokümantasyonu okuyun
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"
  }'

Neler beklenmeli

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Jewelry types

4

Close-up mannequins

built-in

Uçtan uca kod

Dilinizi seçin

Aynı üç rehber — endpoint'i değiştirin, istek gövdesini değiştirin.

SDK

→

Node.js

Native fetch · `/tryon/apparel` yerine `/tryon/jewelry` yazın ve hazırsınız

SDK

→

Python

requests + aynı photta.py wrapper'ı · ek bağımlılık yok

SDK

→

cURL

İki dakikalık duman testi · takı tiplerini doğrulamak için mükemmel

Nasıl çalışır

Giyim akışının küçük ve yüksek yansımalı ürünler için optimize edilmiş hali

Yakın çekim bir manken seçin, gönderin, poll edin, indirin.

  1. 01

    Adım 1

    API anahtarı oluşturun

    Giyim ile aynı akış — ai.photta.app → Geliştiriciler → API anahtarı oluştur. Tek anahtar her endpoint'te çalışır; tek kredi bakiyesi her yeteneği kapsar.

  2. 02

    Adım 2

    Yakın çekim bir manken seçin

    `/api/v1/mannequins?jewelry_type=necklace` (veya ring / bracelet / earrings) şeklinde filtreleyin — Photta, küçük metal ve taşlar için optimize edilmiş cilt dokularına sahip özel bir yakın çekim manken seti sunar.

  3. 03

    Adım 3

    Takı işini POST edin

    `jewelry_type`, `jewelry_images`, `mannequin_id`, `resolution`, `aspect_ratio` ile `/api/v1/tryon/jewelry` adresine POST gönderin. Servis, takı kategorisi için yerleşimi otomatik olarak ölçeklendirir.

  4. 04

    Adım 4

    İş tamamlanana kadar poll edin

    Her 3 saniyede bir GET `/api/v1/tryon/jewelry/:id` yapın. Yanıt yapısı giyim ile aynıdır — `data.status`, `data.output_url`, `data.thumbnail_url`.

  5. 05

    Adım 5

    İndirin ve kalıcı hale getirin

    Ürün detay sayfası (PDP) küçük resimleri için 1:1 dar kesim; editoryal çekimler için daha geniş en-boy oranları en iyisidir. CDN'e doğrudan link vermek yerine byte'ları kendiniz saklayın.

Diğer geliştiricilerin sorduğu sorular

Geliştiricilerin takı deneme özelliğini yayına almadan önce sorduğu sorular

Hangi takı tipleri destekleniyor?+

Dört açık kategori: kolye, yüzük, bilezik, küpe. Her kategorinin kendi yakın çekim manken seti ve o form faktörüne göre ayarlanmış yerleşim sezgiselliği vardır. Yüzükler ve küpeler en çok 1:1 en-boy oranından faydalanır; kolyeler 3:4 oranında iyi görünür.

Takı denemesinin maliyeti nedir?+

Giyim ile aynı: 2K'da 5 kredi, 4K'da 7 kredi. Başarısız işler otomatik olarak iade edilir. Yakın çekim manken kütüphanesi için ek ücret alınmaz.

Takı endpoint'i giyimden nasıl farklı?+

Aynı kimlik doğrulama, aynı polling deseni, aynı yanıt yapısı — farklar istek gövdesindedir. `product_type` ve `product_images` yerine `jewelry_type` ve `jewelry_images` gönderirsiniz ve takı kategorisine göre filtrelenmiş mankenler seçersiniz. Diğer her şey (2K/4K, en-boy oranları, krediler) ortaktır.

Kendi takı modelimi yükleyebilir miyim?+

Evet — `/api/v1/jewelry-mannequins/upload` özel bir yakın çekim referansı kabul eder, `/api/v1/jewelry-mannequins/generate` ise prompt'lardan yenisini üretir. Her ikisi de deneme isteğine geri besleyebileceğiniz bir ID döndürür.

Yansıtıcı metaller ve değerli taşlar nasıl işleniyor?+

Yakın çekim hattı, speküler yansımalar ve mikro geometri hakkında meta veriler taşır. Altın, gümüş ve ayna parlaklığındaki platin, genel amaçlı deneme hatlarının ürettiği gölgelenme veya renk kayması olmadan doğru şekilde işlenir. En iyi sonuçlar için çok temiz stüdyo arka planları önerilir.

Sonuç için polling işlemini nasıl yaparım?+

Her 3 ila 5 saniyede bir GET `/api/v1/tryon/jewelry/:id` yapın. Giyim ile aynı durum yaşam döngüsü: `processing` → `completed` veya `failed`. 1.5 ile 4 dakikalık bir pencere işlerin büyük çoğunluğunu kapsar.

İlgili

İlgili yetenekler

/api/virtual-try-on-api

virtual-try-on

5–7 credits · ~3 min

View capability →

Takı · Yetenek

Hesap oluşturun ve bir API anahtarı alın

Photta'nın takı deneme API'si bir takı fotoğrafı ve bir `jewelry_type` (kolye, yüzük, bilezik veya küpe) kabul eder ve model üzerinde yakın çekim bir fotoğraf döndürür. `Authorization: Bearer photta_live_xxx` ile `/api/v1/tryon/jewelry` adresine POST yapın, dönen ID'yi her 3 saniyede bir poll edin ve durum `completed` olduğunda sonucu indirin.

API anahtarı alın →Fiyatlandırmayı görüntüleyin
Takı Deneme API'si | Photta | Photta