Photta API
Photta API virtual try-on, ghost mannequin, dan fotografi produk via REST
Ringkasan singkat
Photta API adalah REST API berbasis credits: kirim POST foto produk ke endpoint kapabilitas, lakukan polling pada status endpoint-nya setiap beberapa detik, unduh gambar yang sudah selesai. Delapan kapabilitas, satu key, satu saldo credits.
- Kapabilitas: 8 kapabilitas
- Rate limit: 600 requests/min
- Auth: Bearer key
- Pola: async, polling
Setiap angka di halaman ini bersumber dari dokumentasi API Photta · diperiksa
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')const res = await fetch("https://api.photta.app/api/v1/tryon/apparel", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"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."
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/tryon/apparel",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"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."
},
)
data = res.json()["data"] # data["id"], data["status"]Kapabilitas
Setiap endpoint, berdasarkan kapabilitas
Method, path, credits, dan waktu umum, langsung dari dokumentasi API. Angka pada halaman ini diverifikasi terhadap dokumentasi pada tanggal yang tertera di bagian bawah.
- POST/api/v1/tryon/apparel
Virtual Try-On (Pakaian)
Pasang pakaian flat-lay pada manekin AI dengan ekspresi dan ukuran tubuh yang Anda tentukan. Empat product types, lima aspect ratio.
5 credits pada 2K · 6 credits pada 4K1.5–4 min
Lihat endpoint - POST/api/v1/tryon/jewelry
Try-On Perhiasan
Close-up ketat untuk kalung, cincin, gelang, dan anting pada manekin khusus perhiasan — pantulan dan permukaan kecil ditangani dengan presisi.
5 credits pada 2K · 6 credits pada 4K1.5–4 min
Lihat endpoint - POST/api/v1/ghost-mannequin
Ghost Mannequin
Hapus manekin dari foto pakaian dengan konstruksi bagian dalam tetap utuh. Hasil akhir 3D atau flat-lay, siap untuk proses batch.
4 credits pada 2K · 5 credits pada 4K1.5–4 min
Lihat endpoint - POST/api/v1/ghost-mannequin/batch
Batch Ghost Mannequin
Kirim satu deret foto pakaian sekaligus dalam satu panggilan API dan lakukan polling pada satu batch ID; setiap gambar dihitung credit-nya dan dilacak secara terpisah.
4 credits pada 2K · 5 credits pada 4K1.5–4 min per image
Lihat endpoint - POST/api/v1/eyewear-studio
Studio Kacamata
Kacamata baca dan kacamata hitam di-render pada model close-up dengan bentuk bingkai yang tetap presisi sesuai foto produk Anda.
5 credits pada 2K · 6 credits pada 4K20–60 sec
Lihat endpoint - POST/api/v1/detail-photos
Foto Detail
Close-up jahitan, bahan kain, hardware, dan label dari satu foto produk; penganalisis otomatis menyarankan area mana yang perlu diambil.
3 credits20–60 sec
Lihat endpoint - POST/api/v1/mannequins/generate
Pembuatan Manekin
Hasilkan manekin pakaian atau perhiasan Anda sendiri dari berbagai opsi, lalu gunakan kembali ID-nya di setiap panggilan try-on.
4 credits30-60s
Lihat endpoint - POST/api/v1/workflows/{workflow_id}
Workflow
Jalankan workflow bawaan — misalnya foto utama perhiasan — hanya dengan satu panggilan dan dapatkan satu set gambar jadi.
4 credits pada 2K · 5 credits pada 4K20–60 sec / image
Lihat endpoint
Bahasa
Belum ada SDK — dan Anda memang tidak membutuhkannya.
Tiga panduan siap salin yang sama persis dengan rekomendasi dokumentasi Photta saat ini.
Quickstart
Dari pendaftaran hingga gambar pertama dalam lima menit.
Setiap kapabilitas mengikuti pola yang sama: autentikasi, kirim, poll. Pelajari sekali saja.
Langkah 1: Daftar di ai.photta.app dan buat API key live dari dasbor Developers.
Langkah 2: POST job dengan key Anda di header Authorization — API akan langsung mengembalikan ID generasi.
Langkah 3: Lakukan polling ke endpoint yang sama setiap 3 detik hingga status berubah menjadi completed, lalu unduh URL hasilnya.
Pertanyaan
Hal-hal yang ditanyakan developer sebelum mendaftar
Apa itu Photta API?
Photta API adalah layanan REST berbasis credits yang menghasilkan fotografi fashion profesional dari foto produk Anda. Ini adalah pipeline yang sama yang menggerakkan aplikasi konsumen Photta — virtual try-on pakaian, try-on perhiasan, dan ekstraksi ghost mannequin, yang diekspos sebagai delapan kapabilitas bagi developer untuk membangun tool mereka sendiri di atasnya.
Bagaimana cara mendapatkan API key?
Daftar di ai.photta.app, buka bagian Developers di dasbor, klik Generate API key. Key live Anda diawali dengan `photta_live_` yang diikuti oleh 32 karakter hex. Simpan di environment variable — jangan pernah lakukan commit ke source control, jangan pernah kirimkan ke browser.
Apakah ada paket gratis?
Akun baru menerima trial credits yang dapat Anda gunakan untuk kapabilitas apa pun. Setelah siap rilis ke tahap produksi, berlanggananlah ke paket dengan saldo bulanan credits yang lebih tinggi. Rate limit sama di setiap paket: 600 request per menit per API key. Tanpa batas minimum per panggilan.
Seberapa cepat proses generasinya?
Job try-on dan ghost mannequin biasanya selesai dalam 1.5 hingga 4 menit; foto kacamata, foto detail, dan gambar alur kerja dalam 20 hingga 60 detik; pembuatan manekin dalam 30 hingga 60 detik. Setiap endpoint generasi bersifat asinkron: POST langsung mengembalikan ID generasi, dan Anda melakukan polling setiap 3 hingga 5 detik sampai job selesai. Tidak ada koneksi HTTP yang ditahan lama yang perlu dikelola.
Apakah ada SDK resmi dari Photta?
Belum ada. Jalur integrasi yang didukung adalah REST murni via cURL, fetch bawaan Node, atau library requests milik Python — ketiganya terdokumentasi end-to-end di situs ini, untuk setiap kapabilitas.
Referensi
Bagian dokumentasi yang akan Anda buka lebih dari sekali.
Referensi
Gambar Photta pertama dalam waktu kurang dari lima menit.
Daftar, buat API key, jalankan pemanggilan cURL pertama Anda, lakukan polling hingga selesai, simpan hasilnya. Lima langkah, terdokumentasi end-to-end.
BacaReferensi
Autentikasi Photta API
Cara mengautentikasi ke Photta API: header Authorization, prefiks key, tempat pembuatan key, dan cara merotasinya dengan aman.
BacaReferensi
Harga Photta API
Biaya setiap endpoint Photta API dalam credits pada 2K dan 4K, cara kerja pemotongan dan pengembalian dana, serta endpoint mana saja yang gratis. Tidak ada harga uang per gambar.
BacaReferensi
Rate limit Photta API
Rate limit Photta API, window-nya, header Retry-After, interval polling, serta batas konkurensi per paket, seluruhnya dirujuk dari dokumentasi API.
BacaReferensi
Error Photta API
Daftar lengkap tipe error Photta API beserta kode statusnya, format body error, dan kegagalan mana saja yang layak dicoba ulang.
BacaReferensi
Endpoint resource Photta API
Buat daftar maneken, pose, latar belakang, alas kaki, dan label brand, unggah milik Anda sendiri, serta lihat saldo credit Anda. Pencarian di balik setiap pembuatan.
BacaPanduan
Apa itu API virtual try-on?
API virtual try-on merender pakaian pada model dari satu foto produk. Apa inputnya, apa outputnya, berapa biayanya, dan berapa lama prosesnya berjalan.
BacaPanduan
Apa itu ghost mannequin API?
Ghost mannequin API menghapus manekin dari foto pakaian dan merekonstruksi bagian dalamnya. Apa yang dibutuhkan, apa yang dikembalikan, dan berapa biayanya.
BacaPanduan
Migrasi dari FASHN ke Photta
Apa yang berubah saat Anda memindahkan integrasi virtual try-on dari FASHN ke Photta: autentikasi, request body, polling, dan bagaimana credits ditagihkan.
BacaBangun
Bangun dengan API Photta
Delapan resep menyeluruh untuk API Photta: aplikasi try-on, aplikasi Shopify, plugin WooCommerce, worker Django, katalog batch, dan otomatisasi no-code.
BacaBandingkan
API virtual try-on terbaik
Cara kerja lima API virtual try-on — Photta, FASHN, FitRoom, Pixazo, dan Ayna. Apa yang dipublikasikan masing-masing vendor, apa yang tidak, dan tempat untuk membaca rinciannya.
Baca
Setiap angka di halaman ini bersumber dari dokumentasi API Photta · diperiksa
Coba API dalam lima menit
Buat Photta API key, tempel cuplikan cURL di atas, dan Anda akan mendapatkan gambar on-model pertama sebelum kopi selesai diseduh.
- 8 kapabilitas
- 600 requests/min
- Bearer key
- async, polling