Referensi · Resource
Endpoint resource Photta API id yang dibutuhkan setiap pembuatan
Ringkasan singkat
Endpoint resource mengembalikan id yang dibutuhkan oleh panggilan pembuatan: maneken, pose, latar belakang, alas kaki, atribut pakaian, dan label brand, ditambah saldo akun serta penggunaan Anda. Menampilkan daftar tidak memakan biaya.
- Endpoint resource: 13 resource endpoint
- Autentikasi: Bearer key
- Batasan: 600 requests/min
Setiap angka di halaman ini bersumber dari dokumentasi API Photta · diperiksa
Setiap endpoint resource, beserta panggilan yang membacanya
Setiap bagian menautkan kapabilitas yang menggunakan id tersebut.
Maneken
Menampilkan daftar model yang tersedia untuk try-on pakaian: maneken sistem Photta, unggahan Anda sendiri, dan yang Anda buat dengan API pembuatan maneken. Lakukan POST ke path yang sama untuk mengunggah maneken kustom, yang tetap bersifat privat untuk akun Anda. ID tersebut dimasukkan ke dalam `mannequin_id` pada panggilan try-on.
curl https://api.photta.app/api/v1/mannequins \
-H "Authorization: Bearer $PHOTTA_API_KEY"const res = await fetch("https://api.photta.app/api/v1/mannequins", {
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.photta.app/api/v1/mannequins",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]Maneken perhiasan
Mengunggah foto model close-up untuk try-on perhiasan. Pemrosesan perhiasan difokuskan pada garis leher, telinga, pergelangan tangan, atau tangan, sehingga membutuhkan set maneken tersendiri, bukan maneken seluruh badan untuk pakaian.
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/mannequins/jewelry \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"image": "https://cdn.yourstore.com/models/emma-neck.jpg",
"jewelry_type": "necklace",
"gender": "female",
"name": "Emma"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')const res = await fetch("https://api.photta.app/api/v1/mannequins/jewelry", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"image": "https://cdn.yourstore.com/models/emma-neck.jpg",
"jewelry_type": "necklace",
"gender": "female",
"name": "Emma"
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/mannequins/jewelry",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"image": "https://cdn.yourstore.com/models/emma-neck.jpg",
"jewelry_type": "necklace",
"gender": "female",
"name": "Emma"
},
)
data = res.json()["data"] # data["id"], data["status"]Pose
Menampilkan daftar pose yang dapat diminta oleh try-on, dapat difilter berdasarkan kategori dan jenis produk yang cocok. Teruskan id sebagai `pose_id`; jika dikosongkan, API akan memilih pose yang pas dengan pakaian tersebut.
curl https://api.photta.app/api/v1/poses \
-H "Authorization: Bearer $PHOTTA_API_KEY"const res = await fetch("https://api.photta.app/api/v1/poses", {
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.photta.app/api/v1/poses",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]Panjang dan fit pakaian
Mengembalikan key panjang dan fit yang diterima oleh try-on pakaian. Kirimkan key tersebut, bukan deskripsi teks bebas, agar kemeja yang sama dirender secara konsisten di seluruh katalog.
curl https://api.photta.app/api/v1/garment-attributes \
-H "Authorization: Bearer $PHOTTA_API_KEY"const res = await fetch("https://api.photta.app/api/v1/garment-attributes", {
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.photta.app/api/v1/garment-attributes",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]Latar belakang
Menampilkan daftar latar belakang sistem dan unggahan Anda sendiri untuk try-on pakaian, dengan paginasi kursor. Lakukan POST ke path yang sama untuk mengunggah latar belakang kustom; aset ini tetap bersifat privat untuk akun Anda.
curl https://api.photta.app/api/v1/backgrounds \
-H "Authorization: Bearer $PHOTTA_API_KEY"const res = await fetch("https://api.photta.app/api/v1/backgrounds", {
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.photta.app/api/v1/backgrounds",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]Label brand
Mengunggah gambar label yang dapat digunakan kembali untuk pekerjaan ghost mannequin dan mengembalikan id yang Anda teruskan sebagai `brand_label_id`, baik pada tugas tunggal maupun batch. GET menampilkan daftar yang telah Anda simpan; DELETE menghapusnya saat Anda mencapai batas akun.
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/brand-labels \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"file": "@/path/to/pribrand-label.png",
"name": "Pribrand Collar Label"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')const res = await fetch("https://api.photta.app/api/v1/brand-labels", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"file": "@/path/to/pribrand-label.png",
"name": "Pribrand Collar Label"
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/brand-labels",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"file": "@/path/to/pribrand-label.png",
"name": "Pribrand Collar Label"
},
)
data = res.json()["data"] # data["id"], data["status"]Alas kaki
Menampilkan daftar opsi alas kaki untuk try-on pakaian, dapat difilter berdasarkan tipe dan gender, dengan paginasi kursor. Gunakan ini untuk memasang sepatu pada model yang sama yang mengenakan pakaian tersebut.
curl https://api.photta.app/api/v1/footwear \
-H "Authorization: Bearer $PHOTTA_API_KEY"const res = await fetch("https://api.photta.app/api/v1/footwear", {
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.photta.app/api/v1/footwear",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]Akun
Mengembalikan saldo credit Anda yang dirinci berdasarkan sumber, paket Anda saat ini, dan pembaruan credit berikutnya. Baca data ini sebelum menjalankan batch besar daripada menghadapi kendala kekurangan saldo pada 402.
curl https://api.photta.app/api/v1/account \
-H "Authorization: Bearer $PHOTTA_API_KEY"const res = await fetch("https://api.photta.app/api/v1/account", {
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.photta.app/api/v1/account",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]Penggunaan
Jumlah pembuatan dan pengeluaran credit untuk periode penagihan bulan kalender saat ini, dibagi menjadi tugas yang berhasil dan gagal. Endpoint inilah yang sebaiknya dibuatkan grafik, bukan hitungan request Anda sendiri.
curl https://api.photta.app/api/v1/account/usage \
-H "Authorization: Bearer $PHOTTA_API_KEY"const res = await fetch("https://api.photta.app/api/v1/account/usage", {
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.photta.app/api/v1/account/usage",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]Pertanyaan seputar endpoint resource
Untuk apa endpoint resource digunakan?
Endpoint ini mengembalikan id yang dibutuhkan oleh panggilan pembuatan — maneken, pose, latar belakang, label brand — ditambah status akun Anda. Tidak ada endpoint di grup ini yang menghasilkan gambar.
Apakah panggilan resource memakan credit?
Tidak. Menampilkan daftar gratis, dan unggahan dalam grup ini — maneken kustom, latar belakang, label brand — juga gratis. Anda hanya membayar untuk proses pembuatan.
Bagaimana cara melakukan paginasi pada daftar yang panjang?
Endpoint daftar menerima limit dan kursor: teruskan id terakhir yang Anda terima sebagai `starting_after` dan baca halaman berikutnya. Simpan data yang Anda peroleh ke dalam cache daripada mengambil ulang daftar pada setiap request.
Bisakah saya mengunggah maneken dan latar belakang saya sendiri?
Bisa. POST `/api/v1/mannequins`, POST `/api/v1/mannequins/jewelry`, POST `/api/v1/backgrounds`, dan POST `/api/v1/brand-labels` semuanya menerima gambar Anda sendiri, dan semua yang Anda unggah bersifat privat untuk akun Anda.
Tempat id ini digunakan
Kapabilitas
Virtual try-on API untuk pakaian
REST API yang memakaikan pakaian pada manekin AI. Asinkron, waktu generasi 1.5–4 menit, 5 credits pada 2K, 6 pada 4K. Contoh cURL, Node.js, dan Python.
BacaKapabilitas
API try-on perhiasan untuk kalung, cincin, gelang, dan anting
Posisikan kalung, cincin, gelang, dan anting pada model AI via REST. 5 credits pada 2K, manekin close-up bawaan, rendering dengan penanganan refleksi dari dokumentasi Photta.
BacaKapabilitas
Ghost mannequin API untuk foto produk hollow-man
Endpoint AI ghost mannequin. Hapus manekin dari foto pakaian dan pertahankan detail bagian dalam. 3D atau flat-lay, pemrosesan batch, 4 credits pada 2K.
BacaReferensi
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.
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.
- 13 resource endpoint
- Bearer key
- 600 requests/min