Yetenek · Takı
Takı try-on API'si kolyeler, yüzükler, bilezikler ve küpeler için
Tek cümlede
Photta'nın takı try-on API'si bir takı fotoğrafı, bir jewelry_type (kolye, yüzük, bilezik veya küpe) ve bir manken ID'si alır; model üzerinde yakın çekim bir fotoğraf döndürür. POST edin, her 3 saniyede bir poll edin, durum completed olduğunda indirin.
- Tipik süre: 1.5–4 min
- Credits: 2K'da 5 credits · 4K'da 6 credits
- İşleme: asenkron, polling
- Sınırlar: 600 istek/dk
- Kimlik doğrulama: Bearer anahtarı
Bu sayfadaki her veri şuradan alınmıştır: Photta API dokümantasyonu · kontrol edildi
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/jewelry \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jewelry_image": "https://cdn.yourstore.com/products/gold-necklace.jpg",
"jewelry_type": "necklace",
"mannequin_id": "mnk_j9k1l2",
"background": "soft window light on dark velvet",
"resolution": "2K",
"aspect_ratio": "3:4",
"user_instruction": "Make the pendant 10% smaller."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')const res = await fetch("https://api.photta.app/api/v1/tryon/jewelry", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"jewelry_image": "https://cdn.yourstore.com/products/gold-necklace.jpg",
"jewelry_type": "necklace",
"mannequin_id": "mnk_j9k1l2",
"background": "soft window light on dark velvet",
"resolution": "2K",
"aspect_ratio": "3:4",
"user_instruction": "Make the pendant 10% smaller."
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/tryon/jewelry",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"jewelry_image": "https://cdn.yourstore.com/products/gold-necklace.jpg",
"jewelry_type": "necklace",
"mannequin_id": "mnk_j9k1l2",
"background": "soft window light on dark velvet",
"resolution": "2K",
"aspect_ratio": "3:4",
"user_instruction": "Make the pendant 10% smaller."
},
)
data = res.json()["data"] # data["id"], data["status"]
Genel bakış
Genel bakış
- Endpoint
- POST /api/v1/tryon/jewelry
- Kimlik doğrulama
- Bearer API anahtarı
- İşleme
- Asenkron — durum endpoint'ini sorgulayın (poll)
- Tipik süre
- 1.5–4 min
- Credits
- 2K'da 5 credits · 4K'da 6 credits
- En-boy oranları
- 3:4 · 1:1 · 4:3 · 9:16 · 16:9
- Girdi sınırları
- Görsel başına en fazla 10 MB; JPEG, PNG, WebP
- Idempotent
- Hayır
İstek ve yanıt
İstek
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/jewelry \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jewelry_image": "https://cdn.yourstore.com/products/gold-necklace.jpg",
"jewelry_type": "necklace",
"mannequin_id": "mnk_j9k1l2",
"background": "soft window light on dark velvet",
"resolution": "2K",
"aspect_ratio": "3:4",
"user_instruction": "Make the pendant 10% smaller."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')const res = await fetch("https://api.photta.app/api/v1/tryon/jewelry", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"jewelry_image": "https://cdn.yourstore.com/products/gold-necklace.jpg",
"jewelry_type": "necklace",
"mannequin_id": "mnk_j9k1l2",
"background": "soft window light on dark velvet",
"resolution": "2K",
"aspect_ratio": "3:4",
"user_instruction": "Make the pendant 10% smaller."
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/tryon/jewelry",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"jewelry_image": "https://cdn.yourstore.com/products/gold-necklace.jpg",
"jewelry_type": "necklace",
"mannequin_id": "mnk_j9k1l2",
"background": "soft window light on dark velvet",
"resolution": "2K",
"aspect_ratio": "3:4",
"user_instruction": "Make the pendant 10% smaller."
},
)
data = res.json()["data"] # data["id"], data["status"]202 Accepted / Completed
{
"data": {
"id": "jwl_a1b2c3",
"status": "processing",
"jewelry_type": "necklace",
"mannequin_id": "mnk_j9k1l2",
"resolution": "2K",
"aspect_ratio": "3:4",
"credits_used": 5,
"created_at": "2026-04-10T14:00:00Z"
},
"request_id": "req_jwl001"
}{
"data": {
"id": "jwl_a1b2c3",
"status": "completed",
"jewelry_type": "necklace",
"mannequin_id": "mnk_j9k1l2",
"resolution": "2K",
"aspect_ratio": "3:4",
"output_url": "https://cdn.photta.app/generated/jwl_a1b2c3.jpg",
"thumbnail_url": "https://cdn.photta.app/generated/jwl_a1b2c3-thumb.jpg",
"credits_used": 5,
"created_at": "2026-04-10T14:00:00Z",
"completed_at": "2026-04-10T14:01:10Z",
"duration_ms": 70000
},
"request_id": "req_jwl002"
}İstek parametreleri
jewelry_imageTür: stringZorunlu
URL or base64 data URI of the jewelry product image.
jewelry_typeTür: stringZorunlu
Type of jewelry.
Değerler:necklaceearringsbraceletringmannequin_idTür: stringZorunlu
ID of the mannequin. Must be jewelry-compatible and have a matching close-up view for the given jewelry_type. Use GET /api/v1/mannequins?jewelry_type=necklace to find compatible mannequins.
backgroundTür: string
Optional. Pass a URL or base64 data URI to use a reference photo as the scene; pass any other string to use it as a free-form text description (e.g. "soft window light on dark velvet"). When omitted, the original mannequin backdrop is preserved.
resolutionTür: string
Output resolution. "2K" costs 5 credits per image; "4K" costs 6 credits per image. 4K is produced natively in a single generation — pick it upfront; the resolution cannot be changed after creation. 4K cannot be combined with aspect_ratio 1:1 (returns 400).
= 2K
Değerler:2K4Kaspect_ratioTür: string
Output aspect ratio. 1:1 is not available at 4K resolution — that combination returns 400.
= 3:4
Değerler:3:41:14:39:1616:9user_instructionTür: string
Free-form refinement, e.g. "make the pendant 10% smaller", "keep the clasp visible at the back of the neck". Capped at 400 characters server-side; longer strings are silently truncated. Requests to change the jewelry's size, scale, or proportions are honored and take priority; any other instruction applies only where it does not conflict with reproducing the jewelry exactly from the reference image. Not a determinism or seed control.
Hatalar
- 400
invalid_request_error - The request is malformed or contains invalid parameters.
- 401
authentication_error - The API key is missing, invalid, or expired.
- 402
insufficient_credits_error - Your account does not have enough credits.
- 404
not_found_error - The requested resource does not exist.
- 409
conflict_error - The request conflicts with current state — e.g. your concurrent-batch cap is reached.
- 429
rate_limit_error - Too many requests. Slow down and retry.Retry-After: 30
- 500
api_error - An internal server error occurred. Retry later.
Sınırlar
- API anahtarı başına dakikada 600 istek (Sabit pencere; limit her planda aynıdır)
- 429 yanıtı Retry-After: 30 saniye içerir
- Görsel başına en fazla 10 MB
- Formatlar: JPEG, PNG, WebP
- Plan başına eşzamanlı toplu işlem: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
- Yalnızca polling — API webhook göndermez.
Küçük ve yüksek oranda yansıtıcı ürünler için yeniden ayarlanmış giyim akışı
Bir yakın çekim mankeni seçin, gönderin, yoklayın, indirin.
Adım 1
Bir API anahtarı oluşturun
Giyimle aynı akış — ai.photta.app → Developers → Generate API key. Tek bir anahtar tüm endpoint'lerde çalışır; tek bir kredi bakiyesi tüm yetenekleri kapsar.
Adım 2
Bir yakın çekim mankeni seçin
Takı mankenlerini listeleyin veya `POST /api/v1/mannequins/jewelry` ile kendinizinkini yükleyin — Photta, küçük metal ve taşlar için özel olarak ayarlanmış cilt dokularına sahip amaca yönelik bir yakın çekim manken seti sunar.
Adım 3
Takı işini POST edin
`jewelry_image`, `jewelry_type`, `mannequin_id` ve isteğe bağlı `background`, `resolution` ve `aspect_ratio` ile `/api/v1/tryon/jewelry` adresine POST isteği atın. Servis, takı kategorisi için yerleşimi otomatik olarak ölçeklendirir.
Adım 4
İş tamamlanana kadar yoklayın
Her 3 saniyede bir GET `/api/v1/tryon/jewelry/:id` çağrısı yapın. Yanıt yapısı giyim ile tamamen aynıdır — `data.status`, `data.output_url`, `data.thumbnail_url`.
Adım 5
İndirin ve kalıcı hale getirin
PDP küçük resimleri için en iyi sonucu 1:1 sıkı kırpma verir; editoryal görseller için daha geniş en boy oranları uygundur. CDN'e doğrudan bağlantı vermek yerine baytları kendiniz depolayın.
Node.js, Python ve cURL'de aynı endpoint
Node.js
Node.js'te Takı try-on API'si
Yerel fetch ile bir Node.js backend'inden Photta'nın takı try-on API'si özelliğini çağırın. SDK gerekmez: anahtarınızı saklayın, işi gönderin, sonuç için poll edin.
OkuPython
Python'da Takı try-on API'si
Photta'nın takı try-on API'si özelliğini requests kütüphanesiyle Python'da çağırın. Otuz satırlık sarmalayıcı, httpx ile asenkron uyumlu, Django, FastAPI ve Celery içinde çalışır.
OkucURL
cURL ile Takı try-on API'si
Photta'nın takı try-on API'si özelliğini cURL ile doğrudan kabuktan çağırın. Gönderin, yoklayın, indirin — her kod parçacığı betik tabanlı işlem hatları için jq ile uyumludur.
Oku
Geliştiricilerin takı try-on özelliğini yayına almadan önce sorduğu sorular
Hangi takı türleri destekleniyor?
Dört belirgin kategori: kolye, yüzük, bilezik, küpe. Her kategorinin amaca yönelik geliştirilmiş kendi yakın çekim manken seti ve o form faktörüne göre ayarlanmış bir yerleşim sezgiseli vardır. Yüzükler ve küpeler en çok 1:1 en boy oranından faydalanırken; kolyeler 3:4 oranında net şekilde öne çıkar.
Bir takı try-on işleminin maliyeti ne kadar?
Giyim ile aynı: 2K'da 5 kredi, 4K'da 6 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ılaşır?
Aynı kimlik doğrulama, aynı yoklama modeli, aynı yanıt yapısı — farklar sadece istek gövdesindedir. `product_type` ve `product_images` yerine `jewelry_type` ve `jewelry_image` gönderirsiniz ve takı kategorisine göre filtrelenmiş mankenleri seçersiniz. Diğer her şey (2K/4K, en boy oranları, krediler) ortaktır.
Kendi takı modelimi yükleyebilir miyim?
Evet — `POST /api/v1/mannequins/jewelry` özel bir yakın çekim referansı kabul eder, `POST /api/v1/mannequins/jewelry/generate` ise seçeneklerden yola çıkarak yenisini üretir. Her ikisi de try-on isteğine geri besleyebileceğiniz bir kimlik döndürür.
Yansıtıcı metaller ve değerli taşlar nasıl işlenir?
Yakın çekim hattı, speküler parlamalar ve mikro geometri hakkında meta veriler taşır. Altın, gümüş ve ayna parlaklığındaki platin; genel amaçlı try-on hatlarının ürettiği gölgelenme veya kromatik dağılma olmadan doğru şekilde işlenir. En iyi sonuçlar için son derece temiz stüdyo arka planları önerilir.
Sonuç için nasıl yoklama yaparım?
Her 3 ila 5 saniyede bir GET `/api/v1/tryon/jewelry/:id` çağrısı yapın. Giyim ile aynı durum yaşam döngüsü geçerlidir: `processing` → `completed` veya `failed`. 1.5 ila 4 dakikalık bir aralık işlerin büyük çoğunluğunu kapsar.
İlgili yetenekler
Yetenekler
Sanal try-on API'si giyim için
Giysileri yapay zeka mankenlerine yerleştiren REST API. Asenkron, 1.5–4 dakika oluşturma süresi, 2K için 5 credits, 4K için 6 credits. cURL, Node.js ve Python örnekleri.
Endpoint'i görüntüleyinYetenekler
Hayalet manken API'si içi boş manken ürün fotoğrafları için
Yapay zeka hayalet manken endpoint'i. Giysi fotoğrafından mankeni kaldırın ve iç detayları koruyun. 3D veya flat-lay, toplu işleme, 2K'da 4 kredi.
Endpoint'i görüntüleyinGeliştir
Bir yapay zeka ürün fotoğrafçılığı servisi geliştirin
Photta'nın sanal try-on API'sini white-label bir SaaS olarak satmaya yönelik bir kurucu rehberi: kiracı anahtarları, toplu dağıtım, credit başına faturalandırma, SLA gerçekleri.
Endpoint'i görüntüleyinKarşılaştır
Photta vs FASHN — AI moda API'si, yan yana
Photta ve FASHN karşılaştırması: endpoint'ler, kredi fiyatlandırması, plan katmanları, eşzamanlılık limitleri. Her iki şirketin de 2026-04-19 tarihindeki kendi fiyatlandırma sayfalarından derlenmiştir. Uydurma rakamlar yoktur.
Endpoint'i görüntüleyinKarşılaştır
Photta vs Ayna — geliştirici API'ı mı yoksa Shopify öncelikli stüdyo mu?
Photta ve Ayna karşılaştırması: üç REST endpoint'e karşı Shopify öncelikli bir stüdyo + API. İkisinin de güçlü yönleri var. Veriler 2026-04-19 tarihinde her iki siteden alınmıştır.
Endpoint'i görüntüleyinHızlı başlangıç
Beş dakikadan kısa sürede ilk Photta görseli.
Kayıt olun, bir API anahtarı oluşturun, ilk cURL çağrınızı çalıştırın, tamamlanana kadar yoklayın, sonucu kalıcı hale getirin. Beş adım, uçtan uca belgelenmiş.
Endpoint'i görüntüleyinReferans
Photta API hataları
Durum kodlarıyla birlikte Photta API hata tiplerinin tam listesi, bir hata gövdesinin yapısı ve hangi hataların yeniden denenmeye değer olduğu.
Endpoint'i görüntüleyinReferans
Photta API rate limit'leri
Tümü API dokümantasyonundan alınan Photta API rate limit'i, penceresi, Retry-After başlığı, polling aralığı ve plan başına eşzamanlılık sınırları.
Endpoint'i görüntüleyin
Bu sayfadaki her veri şuradan alınmıştır: Photta API dokümantasyonu · kontrol edildi
API'yi beş dakikada deneyin
Bir Photta API key oluşturun, yukarıdaki cURL kod parçacığını yapıştırın; kahveniz demlenmeden önce model üzerindeki ilk görselinizi alın.
- 1.5–4 min
- 2K'da 5 credits · 4K'da 6 credits
- asenkron, polling
- 600 istek/dk
- Bearer anahtarı