Rehber · Sanal try-on

Sanal try-on API'si nedir? ve ne döndürür

Tek cümlede

Sanal try-on API'si, bir giysi fotoğrafı alır ve bu giysinin bir model tarafından giyilmiş görselini döndürür. Fotoğrafı bir manken ve poz ile POST eder, işi poll eder, ardından sonucu indirirsiniz.

API anahtarı alınDokümantasyonu okuyun
  • Tipik süre: 1.5–4 min
  • Credits: 2K'da 5 credits · 4K'da 6 credits
  • İşleme: asenkron, polling

Bu sayfadaki her veri şuradan alınmıştır: Photta API dokümantasyonu · kontrol edildi

Kısa yanıt

Sanal bir try-on API'si, bir giysiyi bir model üzerinde render eden bir HTTP endpoint'idir. Ürünün bir fotoğrafını — genellikle elinizde zaten bulunan düz çekim veya cansız manken üzerindeki fotoğrafı — gönderirsiniz ve servis, bu giysinin giyildiği bir görsel döndürür. Stüdyo yok, model kiralama yok, renk varyantı değiştiğinde yeniden çekim yok.

Çağrı asenkrondur çünkü render işlemi, bir isteğin beklemesi gerekenden daha uzun sürer. Giysiyi istediğiniz model ve pozla birlikte POST edersiniz, API işi kabul edip bir id döndürür ve siz de işin tamamlandığı bildirilene kadar bir durum endpoint'ini poll edersiniz. Tamamlanan görsel, sizin indirip saklayacağınız bir URL olarak gelir.

Yaygın kullanıcılar; hiçbir zaman stüdyoya ulaşmayan ürünler için model üzerinde görsellere ihtiyaç duyan katalog ekipleri, satıcılardan düz çekim fotoğraflar alan pazaryerleri ve bir müşterinin giysiyi markanın tek beden modeli dışındaki bir vücutta görmesini sağlayan uygulamalardır.

Bu işlemi gerçekleştiren endpoint

Elle yazılmamış, Photta API dokümantasyonundan okunmuştur.

Genel bakış

Endpoint
POST /api/v1/tryon/apparel
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

Herhangi bir try-on API'sinde aranması gerekenler

  • Gönderdikleriniz

    Bir https URL'si veya base64 data URI olarak giysi fotoğrafı, artı istediğiniz model ve poz. Photta, görsel başına 10 MB'a kadar JPEG, PNG ve WebP kabul eder.

  • Ne kadar sürer

    Bir web isteği içinde tamamlanamayacak kadar uzun sürer. Photta, endpoint başına tipik bir tamamlanma süresi yayınlar ve her 3 saniyede bir polling yapılmasını bekler — webhook bulunmamaktadır.

  • Maliyeti nedir

    Photta, giysi try-on işlemi için çağrı başına 2K çözünürlükte 5, 4K çözünürlükte 6 credits ücret alır; bu miktar iş başladığında düşülür ve başarısız olduğunda otomatik olarak iade edilir.

  • Hangi limitler geçerlidir

    Anahtar başına dakikada 600 istek şeklinde yayınlanmış bir rate limit ve aynı anda ne kadar render yapılabileceğine dair plan başına bir üst sınır. Katalog boyutunda bir işlem öncesinde her ikisini de okumaya değer.

İlk istek

cURL, Node.js ve Python'da aynı çağrı.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_type": "top",
  "product_images": [
    "https://cdn.yourstore.com/products/shirt-front.jpg"
  ],
  "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
  "product_category": "t_shirt",
  "mannequin_id": "mnk_f3a9b1",
  "pose_id": "pose_c2d4e5",
  "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
  "lock_background": true,
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "body_size": "M",
  "expression": "neutral",
  "user_instruction": "Keep the collar pattern crisp and centered."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

Sanal try-on API'leri hakkında sorular

Bir try-on API'si ne döndürür?

Seçtiğiniz model tarafından giyilen giysinin bir görseli, tamamlanan iş içinde bir URL olarak sunulur. İndirin ve saklayın — teslim URL'si kalıcı bir barındırma alanı değildir.

Bir model fotoğrafına ihtiyacım var mı?

Hayır. Photta, aralarından seçim yapabileceğiniz bir manken kataloğu sunar; ayrıca niteliklerden kendi modelinizi üretebilir veya bir model yükleyebilirsiniz. Sağlamanız gereken tek görsel giysi fotoğrafıdır.

Bunun sanal soyunma odasından farkı nedir?

Soyunma odası, müşteriye dönük bir özelliktir. Bir try-on API'si ise bunun altındaki render adımıdır: bir çağrı girer, bir görsel çıkar. Bunun üzerine bir soyunma odası inşa edebilir veya bunu tamamen katalog fotoğrafları üretmek için kullanabilirsiniz.

Bir try-on çağrısının maliyeti nedir?

Photta ile 2K çözünürlükte 5 credits ve 4K çözünürlükte 6 credits. Başarısız işlerin ücreti iade edilir, bu nedenle yeniden denemenin maliyeti yalnızca yeniden denemenin kendisidir.

Tek bir görsel ne kadar sürer?

Endpoint tipik tamamlanma süresini yayınlar ve iş kendi durumunu bildirir. Bir süre varsaymak yerine her 3 saniyede bir poll edin.

Sıradaki yazı

Bu sayfadaki her veri şuradan alınmıştır: Photta API dokümantasyonu · kontrol edildi

Kendi ürün fotoğrafınızda deneyin

Tek istek, tek poll, tek görsel.

Bir hesap oluşturun ve API anahtarı alınEndpoint'i görüntüleyin
  • 1.5–4 min
  • 2K'da 5 credits · 4K'da 6 credits
  • asenkron, polling