Panduan · Virtual try-on

Apa itu API virtual try-on? dan apa yang dikembalikannya

Ringkasan singkat

API virtual try-on menerima foto pakaian dan mengembalikan gambar pakaian tersebut saat dikenakan oleh seorang model. Anda mengirimkan POST foto beserta manekin dan pose, melakukan polling pada job tersebut, lalu mengunduh hasilnya.

Dapatkan API keyBaca dokumentasi
  • Waktu umum: 1.5–4 min
  • Credits: 5 credits pada 2K · 6 credits pada 4K
  • Pemrosesan: async, polling

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

Jawaban singkat

API virtual try-on adalah endpoint HTTP yang me-render pakaian ke model. Anda mengirimkan foto produk — biasanya foto flat lay atau pada manekin yang sudah Anda miliki — dan layanan ini mengembalikan gambar pakaian tersebut saat dikenakan. Tanpa studio, tanpa booking model, tanpa foto ulang saat varian warna berubah.

Panggilan ini bersifat asinkron karena proses rendering memakan waktu lebih lama dari batas tunggu request biasa. Anda melakukan POST pakaian beserta model dan pose yang diinginkan, API menerima job tersebut dan mengembalikan sebuah id, lalu Anda melakukan polling ke endpoint status hingga job melaporkan bahwa proses selesai. Gambar akhir dikirimkan sebagai URL yang Anda unduh dan simpan sendiri.

Pengguna umumnya adalah tim katalog yang membutuhkan foto on-model untuk produk yang tidak pernah masuk studio, marketplace yang menerima foto flat lay dari penjual, dan aplikasi yang memungkinkan pembeli melihat pakaian pada tubuh selain model fit tunggal milik brand.

Endpoint yang menjalankannya

Diambil langsung dari dokumentasi API Photta, bukan ditulis manual.

Sekilas

Endpoint
POST /api/v1/tryon/apparel
Autentikasi
API key Bearer
Pemrosesan
Asinkron — lakukan polling ke endpoint status
Waktu umum
1.5–4 min
Credits
5 credits pada 2K · 6 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 API try-on apa pun

  • Data yang Anda kirimkan

    Foto pakaian sebagai URL https atau URI data base64, beserta model dan pose yang Anda inginkan. Photta menerima JPEG, PNG, dan WebP hingga 10 MB per gambar.

  • Waktu yang dibutuhkan

    Cukup lama sehingga tidak dapat diselesaikan dalam satu web request. Photta mencantumkan waktu penyelesaian tipikal per endpoint dan memerlukan polling setiap 3 detik — tidak ada webhook.

  • Biaya

    Photta mengenakan biaya credits per panggilan, 5 pada 2K dan 6 pada 4K untuk try-on pakaian, dipotong saat job dimulai dan dikembalikan secara otomatis jika gagal.

  • Batasan yang berlaku

    Rate limit yang dipublikasikan sebesar 600 request per menit per key, serta batas render simultan per paket. Keduanya penting dibaca sebelum menjalankan pemrosesan berskala katalog.

Request pertama

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

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

Pertanyaan seputar API virtual try-on

Apa yang dikembalikan oleh API try-on?

Gambar pakaian yang dikenakan oleh model yang Anda pilih, dikirimkan sebagai URL dalam job yang completed. Unduh dan simpan gambar tersebut — URL pengiriman bukan hosting permanen.

Apakah saya memerlukan foto model?

Tidak. Photta menyediakan katalog manekin yang dapat Anda pilih, dan Anda dapat men-generate model Anda sendiri dari atribut atau mengunggahnya. Foto pakaian adalah satu-satunya gambar yang wajib Anda sediakan.

Apa perbedaannya dengan virtual fitting room?

Fitting room adalah fitur yang berhadapan langsung dengan pembeli. API try-on adalah tahap render di baliknya: satu panggilan masuk, satu gambar keluar. Anda dapat membangun fitting room di atasnya, atau menggunakannya murni untuk memproduksi foto katalog.

Berapa biaya satu panggilan try-on?

Dengan Photta, 5 credits pada 2K dan 6 pada 4K. Job yang failed akan di-refund, sehingga biaya retry hanyalah pemanggilan retry itu sendiri.

Berapa lama waktu yang dibutuhkan untuk satu gambar?

Endpoint mempublikasikan waktu penyelesaian tipikalnya, dan job melaporkan statusnya sendiri. Lakukan polling setiap 3 detik daripada berasumsi mengenai durasinya.

Baca selanjutnya

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

Coba pada foto produk Anda sendiri

Satu request, satu poll, satu gambar.

Buat akun dan dapatkan API keyLihat endpoint
  • 1.5–4 min
  • 5 credits pada 2K · 6 credits pada 4K
  • async, polling