Pakaian · Kapabilitas

API Virtual Try-On — Photta

Satu panggilan REST mengubah foto pakaian flat-lay menjadi foto model siap kampanye. Asinkron, 1.5–4 menit per generasi, 5 kredit pada 2K atau 7 kredit pada 4K.

Dalam satu kalimat

API virtual try-on Photta menerima gambar pakaian flat-lay, mannequin ID, dan pose ID, lalu mengembalikan foto model 2K atau 4K. Autentikasi dengan `Authorization: Bearer photta_live_xxx`, POST ke `/api/v1/tryon/apparel`, poll endpoint yang sama dengan ID generasi yang dikembalikan setiap 3–5 detik, dan unduh hasil saat status berubah menjadi `completed`.

Dapatkan API key→Baca dokumentasi

POST/api/v1/tryon/apparel

cURL

curl -X POST https://ai.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_type": "dress",
    "product_images": ["https://example.com/dress.jpg"],
    "mannequin_id": "mnq_athena_ts",
    "pose_id": "pose_standing_front",
    "resolution": "2K",
    "aspect_ratio": "3:4"
  }'

Apa yang diharapkan

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Aspect ratios

Product types

Kode, ujung ke ujung

Pilih bahasa Anda

Endpoint yang sama, tiga panduan siap pakai. Setiap snippet sesuai dengan dokumentasi resmi Photta.

SDK

→

Node.js

fetch bawaan di Node 18+ · Siap untuk server actions Next.js

SDK

→

Python

requests + wrapper 30 baris · Django / FastAPI / Celery

SDK

→

cURL

Uji shell dua menit · pipeline jq · nol instalasi

Cara kerja

Empat panggilan API, satu foto produk

Pilih manekin dan pose, kirim job, poll hingga selesai, unduh hasilnya.

01
Langkah 1
Buat API key
Daftar di ai.photta.app, buka tab Developers, klik Generate API key. Key live dimulai dengan `photta_live_`. Simpan key di `PHOTTA_API_KEY` — jangan pernah di-commit.
02
Langkah 2
Pilih manekin dan pose
Panggil GET `/api/v1/mannequins` dan `/api/v1/poses` untuk melihat opsi yang tersedia. Pilih ID yang sesuai dengan brand Anda — ukuran tubuh, ekspresi, etnis, dan kategori pose semua bisa difilter.
03
Langkah 3
POST job try-on
Kirim POST ke `/api/v1/tryon/apparel` dengan `product_type`, `product_images`, `mannequin_id`, `pose_id`, `resolution`, `aspect_ratio`. API mengembalikan 202 Accepted dengan ID generasi.
04
Langkah 4
Poll hingga job selesai
Panggil GET `/api/v1/tryon/apparel/:id` setiap 3 detik. Saat `data.status` menjadi `completed`, payload akan berisi `output_url` dan `thumbnail_url`. Berikan batas waktu maksimal agar job yang macet tidak menggantung request Anda.
05
Langkah 5
Unduh dan simpan
Ambil byte dari `output_url` dan simpan di penyimpanan objek Anda sendiri. URL CDN bersifat stabil tetapi produk Anda sebaiknya tidak bergantung padanya untuk rendering.

Pertanyaan pengembang lainnya

Pertanyaan pengembang sebelum deploy try-on pakaian

Apa itu API virtual try-on Photta?+

Endpoint REST yang menerima foto produk flat-lay dan sepasang ID (manekin + pose) lalu mengembalikan gambar model fotorealistik. Pipeline yang sama dengan aplikasi konsumen Photta. Enam tipe produk didukung: atasan, bawahan, atasan+bawahan, gaun, one-piece, jumpsuit.

Berapa biaya per panggilan?+

5 kredit untuk hasil 2K, 7 kredit untuk 4K. Kredit disertakan dalam langganan Anda dan bisa ditambah. Generasi yang gagal tidak memakan biaya — kredit akan dikembalikan.

Berapa lama proses generasinya?+

Penyelesaian tipikal adalah 1.5 hingga 4 menit, diukur ujung ke ujung. POST mengembalikan ID generasi dalam kurang dari satu detik; pekerjaan GPU dilakukan di latar belakang saat Anda melakukan polling.

Tipe produk apa saja yang didukung?+

Enam: `top`, `bottom`, `top_and_bottom`, `dress`, `one_piece`, `jumpsuit`. Masing-masing mengharapkan struktur `product_images` yang berbeda — misalnya `top_and_bottom` membutuhkan URL `top_image` dan `bottom_image`.

Bisakah saya menggunakan manekin sendiri?+

Ya. Unggah foto manekin ke `/api/v1/mannequins/upload` atau buat manekin AI baru dengan `/api/v1/mannequins/generate-model`. ID yang dikembalikan bisa langsung dimasukkan ke request try-on.

Bagaimana cara polling untuk hasilnya?+

Panggil GET `/api/v1/tryon/apparel/:id` setiap 3 hingga 5 detik sampai `data.status` bernilai `completed` atau `failed`. Berikan batas maksimal percobaan — 120 × 3 detik mencakup jendela waktu yang didokumentasikan dengan aman.

Terkait