Yetenek · Hayalet manken

Hayalet manken API'si içi boş manken ürün fotoğrafları için

Tek cümlede

Photta'nın hayalet manken API'si, manken üzerindeki giysi fotoğrafını alır ve giysinin içi yeniden yapılandırılmış görünmez mankenli bir görsel döndürür. 3d veya flat_lay stilini seçin, POST edin, her 3 saniyede bir yoklayın, tamamlandığında indirin.

  • Tipik süre: 1.5–4 min
  • Credits: 2K'da 4 credits · 4K'da 5 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

POST/api/v1/ghost-mannequin
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/ghost-mannequin \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
  "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
  "image_side": "front",
  "angle": "side",
  "style": "3d",
  "background_color": "white",
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "user_instruction": "closed front, cream interior lining",
  "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')
A garment shown without its mannequin by the ghost mannequin API
Örnek çıktı

Genel bakış

Genel bakış

Endpoint
POST /api/v1/ghost-mannequin
Kimlik doğrulama
Bearer API anahtarı
İşleme
Asenkron — durum endpoint'ini sorgulayın (poll)
Tipik süre
1.5–4 min
Credits
2K'da 4 credits · 4K'da 5 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/ghost-mannequin \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
  "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
  "image_side": "front",
  "angle": "side",
  "style": "3d",
  "background_color": "white",
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "user_instruction": "closed front, cream interior lining",
  "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

202 Accepted / Completed

{
  "data": {
    "id": "gm_d4e5f6",
    "status": "processing",
    "style": "3d",
    "angle": "side",
    "background_color": "white",
    "resolution": "2K",
    "aspect_ratio": "3:4",
    "credits_used": 4,
    "created_at": "2026-04-10T16:00:00Z"
  },
  "request_id": "req_gm001"
}

İstek parametreleri

product_image

Tür: stringZorunlu

URL or base64 data URI of the garment photo (front or back, on a mannequin or flat).

back_image

Tür: string

URL or base64 data URI of the opposite side — helps the AI reconstruct the interior of the garment for a more realistic 3D effect.

image_side

Tür: string

Which side product_image represents.

= front

Değerler: frontback
angle

Tür: string

Camera angle for the output. "side" is worth calling out: the side view is reconstructed from the front photo (plus the back photo when provided), giving you a third catalog view without a third photoshoot — and it works well even on textured garments (crochet, lace, embroidery).

= straight

Değerler: straightbackside
style

Tür: string

Output style: "3d" (ghost mannequin with 3D body shape) or "flat_lay" (garment laid flat, mannequin removed).

= 3d

Değerler: 3dflat_lay
background_color

Tür: string

Background color.

= white

Değerler: whitegraybeigeblack
resolution

Tür: string

Output resolution. "2K" costs 4 credits per image; "4K" costs 5 credits per image. 4K is produced natively in a single generation — pick it upfront; the resolution cannot be changed after creation. Note: 4K cannot be combined with aspect_ratio 1:1 — that combination returns 400.

= 2K

Değerler: 2K4K
aspect_ratio

Tür: string

Output aspect ratio. Note: 1:1 is not available at 4K resolution — 1:1 combined with 4K returns 400.

= 3:4

Değerler: 3:41:14:39:1616:9
user_instruction

Tür: string

Optional free-form note, max 400 characters (anything longer is silently truncated). A guarded steer for ambiguous rendering choices — e.g. "closed front", "cream interior lining", "buttoned up" — it never overrides the source garment, brand label, or structural reconstruction, and it is explicitly NOT a determinism/seed control.

brand_label_id

Tür: string

Brand label UUID returned by the Brand Labels API. Applied to the generated garment when present. API v1 request fields use snake_case; use brand_label_id.

Hatalar

400invalid_request_error
The request is malformed or contains invalid parameters.
401authentication_error
The API key is missing, invalid, or expired.
402insufficient_credits_error
Your account does not have enough credits.
404not_found_error
The requested resource does not exist.
409conflict_error
The request conflicts with current state — e.g. your concurrent-batch cap is reached.
429rate_limit_error
Too many requests. Slow down and retry.Retry-After: 30
500api_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.

Bir kaynak fotoğraf girer, bir hayalet manken fotoğrafı çıkar

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

  1. Adım 1

    Bir API anahtarı oluşturun

    Hayalet manken, diğer tüm Photta yetenekleriyle aynı kimlik bilgilerini kullanır — tek anahtar, tek kredi bakiyesi.

  2. Adım 2

    Kaynak fotoğrafı yükleyin

    `product_image` alanında herkese açık bir URL veya base64 data URI gönderin; arka görünüm varsa `back_image` ekleyin. Görsel başına 10 MB'a kadar JPEG, PNG ve WebP.

  3. Adım 3

    Hayalet manken işini POST edin

    `product_image`, `style` (`3d` veya `flat_lay`) ve isteğe bağlı `angle`, `background_color`, `resolution` parametreleriyle `/api/v1/ghost-mannequin` adresine POST isteği atın. Tamamlanma bildiriminin tek yolu polling'dir — API webhook göndermez.

  4. Adım 4

    İş tamamlanana kadar poll edin

    `data.status` değeri `completed` veya `failed` olana kadar her 3 saniyede bir GET `/api/v1/ghost-mannequin/:id` isteği atın; tipik tamamlanma süresi 1.5 ila 4 dakikadır.

  5. Adım 5

    İndirin ve kalıcı olarak saklayın

    Çıktı, mankenin kaldırıldığı ve giysinin iç kısmının yeniden oluşturulduğu bir PNG'dir. PDP hayalet çekimleri, 3D hissi veren ürün galerileri ve flat-lay eklemeleri için idealdir.

Geliştiricilerin hayalet mankeni canlıya almadan önce sorduğu sorular

Hayalet manken fotoğrafçılığı nedir?

Giysinin görünmez bir gövdede havada durduğu, şeklini ve iç yapısını aynı anda sergilediği bir PDP sunumudur. Tarihsel olarak birden fazla stüdyo çekiminin birleştirilmesiyle yapılır; Photta'nın API'si ise mankenli tek bir fotoğraftan tek bir çağrıda bunu üretir.

Hayalet manken ne kadar tutar?

2K'da 4 credits, 4K'da 5 credits — her katmanda try-on'a göre bir kredi daha ucuz. Başarısız işlerin kredisi otomatik olarak iade edilir.

3D ile flat-lay stili arasındaki fark nedir?

`3d` stili mankenin üç boyutlu vücut formunu korur — giysi hacmini korur, omuzlar ve kollar doğal görünür ve iç kısım yeniden oluşturulur. `flat_lay` ise giysiyi net bir 2D serime dönüştürür; kapsül koleksiyonlar veya tutarlı bir önden görünüm bekleyen pazaryeri listelemeleri için idealdir.

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

Evet. Kaynak görsellerden oluşan bir diziyle `/api/v1/ghost-mannequin/batch` adresine POST isteği atın. Yanıt size bir toplu iş ID'si ve öğe başına üretim ID'leri verir. Genel durum için `/api/v1/ghost-mannequin/batch/:id` adresini veya her öğeyi ayrı ayrı poll edin.

İç dikişleri ve etiketleri korur mu?

Evet — model genel geçer bir yüzey uydurmak yerine giysinin içini (yaka içi, kol ağzı içi, bel astarı) yeniden oluşturur. Orijinal fotoğrafta görünen etiketler ve baskılı ibareler mümkün olduğunca korunur.

Sonuç için nasıl polling yaparım?

Her 3 saniyede bir GET `/api/v1/ghost-mannequin/:id` isteği atın. Toplu işler, genel bir durum ve öğe bazında döküm döndüren bir üst endpoint'i poll eder.

İlgili yetenekler

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 4 credits · 4K'da 5 credits
  • asenkron, polling
  • 600 istek/dk
  • Bearer anahtarı