Giyim · Yetenek

Sanal Giyim Deneme API'si — Photta

Tek bir REST çağrısı, flat-lay bir giysi fotoğrafını kampanyaya hazır, model üzerinde bir görsele dönüştürür. Asenkron, üretim başına 1.5–4 dakika, 2K'da 5 kredi veya 4K'da 7 kredi.

Tek cümlede

Photta'nın sanal giyim deneme API'si bir flat-lay giysi görseli, bir mannequin ID ve bir pose ID kabul eder, ardından 2K veya 4K model üzerinde bir fotoğraf döndürür. `Authorization: Bearer photta_live_xxx` ile kimlik doğrular, `/api/v1/tryon/apparel` adresine POST yapar, dönen generation ID ile her 3–5 saniyede bir aynı endpoint'i sorgular ve durum `completed` olduğunda sonucu indirirsiniz.

API anahtarı alın→Dokümantasyonu okuyun

POST/api/v1/tryon/apparel

cURL

curl -X POST https://ai.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_type": "dress",
    "product_images": ["https://example.com/dress.jpg"],
    "mannequin_id": "mnq_athena_ts",
    "pose_id": "pose_standing_front",
    "resolution": "2K",
    "aspect_ratio": "3:4"
  }'

Neler beklenmeli

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Aspect ratios

Product types

Uçtan uca kod

Dilinizi seçin

Aynı endpoint, üç çalıştırılabilir rehber. Her kod parçası resmi Photta dokümanlarıyla eşleşir.

SDK

→

Node.js

Node 18+ native fetch · Next.js server actions için hazır

SDK

→

Python

requests + 30 satırlık wrapper · Django / FastAPI / Celery

SDK

→

cURL

İki dakikalık shell testi · jq pipeline'ları · kurulum gerektirmez

Nasıl çalışır

Dört API çağrısı, tek ürün fotoğrafı

Bir manken ve bir poz seçin, işi gönderin, bitene kadar poll edin, sonucu indirin.

01
Adım 1
API anahtarı oluşturun
ai.photta.app adresinden kaydolun, Geliştiriciler sekmesini açın, Generate API key'e tıklayın. Canlı anahtarlar `photta_live_` ile başlar. Anahtarı `PHOTTA_API_KEY` değişkenine koyun — asla commit etmeyin.
02
Adım 2
Bir manken ve bir poz seçin
Mevcut seçenekleri listelemek için GET `/api/v1/mannequins` ve `/api/v1/poses` kullanın. Markanıza uyan ID'leri seçin — vücut ölçüsü, ifade, etnik köken ve poz kategorisi filtrelenebilir.
03
Adım 3
Deneme işini POST edin
`product_type`, `product_images`, `mannequin_id`, `pose_id`, `resolution`, `aspect_ratio` ile `/api/v1/tryon/apparel` adresine bir POST gönderin. API, bir generation ID ile 202 Accepted döndürür.
04
Adım 4
İş tamamlanana kadar poll edin
Her 3 saniyede bir GET `/api/v1/tryon/apparel/:id` yapın. `data.status` değeri `completed` olduğunda, payload `output_url` ve `thumbnail_url` içerir. Hatalı bir işin isteğinizi askıda bırakmaması için bir üst sınır koyun.
05
Adım 5
İndirin ve kalıcı hale getirin
`output_url` üzerinden byte'ları çekin ve kendi nesne depolama alanınızda saklayın. CDN URL'si sabittir ancak ürününüz görüntüleme için ona bağımlı olmamalıdır.

Diğer geliştiricilerin sorduğu sorular

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

Photta'nın sanal giyim deneme API'si nedir?+

Bir flat-lay ürün görseli ve bir çift ID (manken + poz) alan ve fotorealistik bir model görseli döndüren bir REST endpoint'idir. Photta'nın tüketici uygulamasıyla aynı hattı kullanır. Altı ürün tipi desteklenir: üst, alt, üst+alt, elbise, tek parça, tulum.

Çağrı başına maliyeti ne kadar?+

2K sonuç için 5 kredi, 4K için 7 kredi. Krediler aboneliğinizle birlikte gelir ve ekleme yapılabilir. Başarısız üretimler kredi tüketmez — iade edilirler.

Bir üretim ne kadar sürer?+

Uçtan uca ölçüldüğünde tipik tamamlanma süresi 1.5 ile 4 dakikadır. POST işlemi bir saniyenin altında bir generation ID döndürür; GPU çalışması siz poll ederken arka planda gerçekleşir.

Hangi ürün tipleri destekleniyor?+

Altı adet: `top`, `bottom`, `top_and_bottom`, `dress`, `one_piece`, `jumpsuit`. Her biri farklı bir `product_images` yapısı bekler — örneğin `top_and_bottom` hem `top_image` hem de `bottom_image` URL'lerini ister.

Kendi mankenimi kullanabilir miyim?+

Evet. `/api/v1/mannequins/upload` adresine bir manken fotoğrafı yükleyin veya `/api/v1/mannequins/generate-model` ile yeni bir yapay zeka mankeni oluşturun. Dönen ID doğrudan deneme isteğine yerleştirilir.

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

`data.status` değeri `completed` veya `failed` olana kadar her 3 ila 5 saniyede bir GET `/api/v1/tryon/apparel/:id` yapın. Deneme sayısına bir üst sınır koyun — 120 × 3s süresi, dokümante edilen pencereyi fazlasıyla kapsar.

İlgili