Ghost Mannequin · Yetenek

Ghost Mannequin API — Photta

Giyim fotoğrafından mankeni çıkarın ve dikişler, astarlar, etiketler dahil iç yapıyı tamamen sağlam tutun. Hollow-man veya flat-lay bitişi, toplu işlemlere hazır, 2K'da 4 kredi.

Tek cümlede

Photta'nın ghost mannequin API'si manken üzerindeki bir giysi fotoğrafını alır ve giysinin içi yeniden yapılandırılmış şekilde görünmez mankenli bir görsel döndürür. Bir `product_image_url`, bir `style` (hollow_man veya flat_lay) ve bir çözünürlük ile `/api/v1/ghost-mannequin` adresine POST yapın. Durum `completed` olana kadar her 3 saniyede bir `/api/v1/ghost-mannequin/:id` adresini sorgulayın.

API anahtarı alın→Dokümantasyonu okuyun

POST/api/v1/ghost-mannequin

cURL

curl -X POST https://ai.photta.app/api/v1/ghost-mannequin \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_image_url": "https://example.com/tshirt-on-model.jpg",
    "style": "hollow_man",
    "resolution": "2K"
  }'

Neler beklenmeli

Typical completion

1–3min

2K / 4K credits

4 / 6

Styles

Batch-ready

yes

Uçtan uca kod

Dilinizi seçin

Aynı REST sözleşmesi; ghost mannequin endpoint'i toplu katalog çalışmaları için batch işlemeyi de destekler.

SDK

→

Node.js

Native fetch · toplu işler için BullMQ veya Inngest ile temiz bir şekilde eşleşir

SDK

→

Python

Paralel gönderim gerektiğinde requests + asyncio

SDK

→

cURL

Batch payload'larını bağlamadan önce duman testi yapmak için ideal

Nasıl çalışır

Bir fotoğraf girer, bir görünmez mankenli fotoğraf çıkar

Kaynağı yükleyin, bir stil seçin, gönderin, poll edin, indirin.

01
Adım 1
API anahtarı oluşturun
Ghost mannequin, diğer tüm Photta yetenekleriyle aynı kimlik bilgilerini kullanır — tek anahtar, tek kredi bakiyesi.
02
Adım 2
Kaynak fotoğrafı yükleyin
`product_image_url` içinde genel bir URL iletebilir veya byte'ları önce `/api/v1/uploads` üzerinden yükleyebilirsiniz. Endpoint JPG, PNG ve WebP kabul eder.
03
Adım 3
Ghost mannequin işini POST edin
`product_image_url`, `style` (hollow_man veya flat_lay) ve `resolution` ile `/api/v1/ghost-mannequin` adresine POST gönderin. İş tamamlandığında ping almak istiyorsanız `webhook_url` iletin — polling hala birincil yol olarak çalışır.
04
Adım 4
İş tamamlanana kadar poll edin
Her 3 saniyede bir GET `/api/v1/ghost-mannequin/:id` yapın. Ghost mannequin, yeni bir kişi işlenmediği için denemeden daha hızlıdır — genellikle 1 ile 3 dakika sürer.
05
Adım 5
İndirin ve kalıcı hale getirin
Çıktı, mankenin çıkarıldığı ve giysinin içinin yapılandırıldığı bir PNG'dir. PDP ghost çekimleri, 3D hissi veren ürün galerileri ve flat-lay eklemeler için idealdir.

Diğer geliştiricilerin sorduğu sorular

Geliştiricilerin ghost mannequin özelliğini yayına almadan önce sorduğu sorular

Ghost mannequin fotoğrafçılığı nedir?+

Giysinin görünmez bir vücut üzerinde yüzüyor gibi göründüğü, hem şekli hem de iç yapıyı aynı anda gösteren bir PDP uygulamasıdır. Tarihsel olarak birden fazla stüdyo çekiminin birleştirilmesiyle oluşturulur; Photta API'si bunu manken üzerindeki tek bir fotoğraftan tek çağrıda üretir.

Ghost mannequin maliyeti ne kadar?+

2K'da 4 kredi, 4K'da 6 kredi — her seviyede denemeden bir kredi daha ucuzdur. Başarısız işler otomatik olarak iade edilir.

Hollow-man ve flat-lay stilleri arasındaki fark nedir?+

Hollow-man mankenin 3D vücut şeklini korur — giysi hacmini korur, omuzlar ve kollar doğal görünür ve iç kısım yapılandırılır. Flat-lay, giysiyi temiz bir 2D yerleşime dönüştürür; kapsül koleksiyonlar veya tutarlı bir ön yüz şekli bekleyen pazaryeri listeleri için idealdir.

Birden fazla fotoğrafı toplu işleyebilir miyim?+

Evet. Bir kaynak görseller dizisiyle `/api/v1/ghost-mannequin/batch` adresine POST yapın. Yanıt size bir batch ID ve her öğe için ayrı generation ID'ler verir. Toplu durum için `/api/v1/ghost-mannequin/batch/:id` adresini veya her öğeyi tek tek sorgulayın.

İç dikişleri ve etiketleri koruyor mu?+

Evet — model, genel bir yüzey uydurmak yerine giysinin içini (yaka içi, manşet içi, bel astarı) yeniden yapılandırır. Orijinal fotoğrafta görünen etiketler ve baskılı ibareler mümkün olduğunda korunur.

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

Her 3 saniyede bir GET `/api/v1/ghost-mannequin/:id` yapın. Toplu işler, genel bir durum ve her öğe için ayrıntı döndüren bir ana endpoint'i sorgular.

İlgili