Panduan · Ghost mannequin

Apa itu ghost mannequin API? foto invisible-mannequin

Ringkasan singkat

Ghost mannequin API menerima foto pakaian pada manekin dan mengembalikan pakaian yang sama dengan manekin yang telah dihapus serta bagian dalam yang direkonstruksi, sehingga pakaian tampak mempertahankan bentuknya sendiri.

  • Waktu umum: 1.5–4 min
  • Credits: 4 credits pada 2K · 5 credits pada 4K
  • Pemrosesan: async, polling

Setiap angka di halaman ini bersumber dari dokumentasi API Photta · diperiksa

Jawaban singkat

Fotografi ghost mannequin — juga disebut hollow man atau invisible mannequin — menampilkan pakaian yang mempertahankan bentuknya tanpa ada tubuh di dalamnya. Secara tradisional, ini digabungkan dalam tahap pascaproduksi dari beberapa frame studio: pakaian pada manekin, lalu manekin dihapus, kemudian bagian dalam kerah dan manset dikomposisikan kembali.

Ghost mannequin API melakukan hal tersebut dalam satu panggilan. Anda mengirimkan foto pada manekin, layanan akan menghapus bentuk manekin dan merekonstruksi apa yang seharusnya terlihat di bagian dalam pakaian — bagian dalam garis leher, lapisan manset, ban pinggang — dan mengembalikan gambar akhir. Seperti halnya try-on, panggilannya bersifat asinkron: submit, poll, download.

Ini adalah perlakuan standar halaman detail produk untuk pakaian, sehingga pemanggilnya adalah tim katalog dan marketplace yang membutuhkan tampilan konsisten di ribuan item tanpa perlu memesan jadwal studio untuk setiap pakaian.

Endpoint yang menjalankannya

Dibaca langsung dari dokumentasi Photta API, bukan ditulis manual.

Sekilas

Endpoint
POST /api/v1/ghost-mannequin
Autentikasi
API key Bearer
Pemrosesan
Asinkron — lakukan polling ke endpoint status
Waktu umum
1.5–4 min
Credits
4 credits pada 2K · 5 credits pada 4K
Rasio aspek
3:4 · 1:1 · 4:3 · 9:16 · 16:9
Batas input
Hingga 10 MB per gambar; JPEG, PNG, WebP
Idempoten
Tidak

Hal yang perlu diperhatikan dalam ghost mannequin API

  • Apa yang Anda kirimkan

    Pakaian yang difoto pada manekin, ditambah tampilan belakang opsional. Photta menerima JPEG, PNG, dan WebP hingga 10 MB per gambar.

  • Hasil akhir mana yang Anda dapatkan

    Endpoint Photta menerima style: 3d mempertahankan volume tiga dimensi pakaian, flat_lay meratakannya menjadi tata letak depan yang rapi.

  • Berapa biayanya

    4 credits pada 2K dan 5 pada 4K di Photta — satu credit lebih murah daripada try-on di setiap tier, di-refund secara otomatis saat tugas gagal.

  • Apakah mendukung batching

    Pekerjaan katalog datang dalam jumlah banyak, bukan satuan. Photta memiliki batch endpoint yang menerima sebuah array, mencadangkan credits di awal, dan melaporkan status per item.

Request pertama

Panggilan yang sama dalam cURL, Node.js, dan Python.

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')

Pertanyaan seputar ghost mannequin API

Apa itu foto ghost mannequin?

Foto produk di mana pakaian tampak melayang, mempertahankan bentuknya tanpa terlihat adanya tubuh atau gantungan. Ini memperlihatkan fit dan konstruksi interior secara bersamaan, itulah mengapa format ini menjadi default pada halaman produk pakaian.

Apa yang saya kirimkan ke endpoint?

Foto pakaian pada manekin. Tampilan belakang bersifat opsional dan meningkatkan hasil rekonstruksi ketika pakaian terbuka atau reversible.

Haruskah saya memilih 3d atau flat lay?

3d jika Anda ingin pakaian terlihat seperti sedang dikenakan — volume, bahu, lengan. flat_lay ketika listing memerlukan bentuk menghadap ke depan yang konsisten, yang sering kali diwajibkan oleh marketplace.

Berapa biaya untuk satu gambar?

Di Photta, 4 credits pada 2K dan 5 pada 4K. Dalam batch, harga per gambar yang sama dicadangkan di awal untuk keseluruhan proses.

Bisakah saya memproses seluruh katalog?

Bisa, melalui batch endpoint. Ukuran batch dan berapa banyak batch yang dapat berjalan bersamaan mengikuti paket Anda, sehingga katalog besar berjalan sebagai rangkaian batch.

Proses satu pakaian melaluinya

Satu foto masuk, satu foto invisible-mannequin keluar.

  • 1.5–4 min
  • 4 credits pada 2K · 5 credits pada 4K
  • async, polling