Referensi · Rate limit
Rate limit Photta API dan cara melakukan polling dengan tepat
Ringkasan singkat
Photta API mengizinkan 600 permintaan per menit per API key dalam fixed window. Respons 429 menyertakan Retry-After: 30. Lakukan polling tugas setiap 3 detik; proses konkuren dibatasi berdasarkan paket.
- Batasan: 600 requests/min
- Retry-After: Retry-After: 30s
- Pemrosesan: async, polling
Setiap angka di halaman ini bersumber dari dokumentasi API Photta · diperiksa
Batasan yang dipublikasikan
Rate, window, percobaan ulang, ukuran gambar, dan format, sesuai yang tercantum dalam dokumentasi.
Batasan
- 600 request per menit per API key (Fixed window; batasannya sama di setiap paket)
- Respons 429 menyertakan Retry-After: 30 detik
- Hingga 10 MB per gambar
- Format: JPEG, PNG, WebP
- Batch konkuren per paket: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
- Hanya polling — API tidak mengirim webhook.
Proses konkuren berdasarkan paket
Berapa banyak batch yang dapat berjalan bersamaan sebelum pengiriman mengembalikan 409.
Batch yang sedang berjalan per paket
Free
Konkuren: 1
Hobby
Konkuren: 2
Seller
Konkuren: 3
Brand
Konkuren: 4
Studio
Konkuren: 6
Tetap berada di dalam batas
Sebuah fixed window
Batas dihitung per API key dalam fixed window, dan nilainya sama pada setiap paket. Dua kunci berarti dua kuota.
Lakukan polling setiap 3 detik
Polling adalah satu-satunya sinyal penyelesaian — API tidak mengirimkan webhook. Interval 3 detik adalah waktu yang terdokumentasi; frekuensi yang lebih cepat hanya akan menghabiskan kuota Anda untuk respons kosong.
Terapkan exponential backoff
Setelah 429, tunggu sejumlah detik pada Retry-After lalu perbesar interval pada setiap kegagalan berikutnya, alih-alih mencoba ulang dengan interval tetap.
Batch dibatasi secara terpisah
Rate limit menghitung request; batas konkurensi menghitung proses yang sedang berjalan. Batch yang melebihi batas akan mengembalikan 409, bukan 429.
Pertanyaan seputar rate limit
Berapa rate limit-nya?
600 request per menit per API key, dalam fixed window. Dokumentasi mencantumkan angka yang sama di setiap endpoint.
Seberapa sering saya harus melakukan polling pada job?
Setiap 3 detik. Tidak ada webhook, jadi polling adalah cara resmi yang terdokumentasi untuk mengetahui bahwa sebuah job telah selesai.
Berapa banyak yang bisa dirender sekaligus?
Batch yang sedang berjalan dibatasi berdasarkan paket: Free 1, Hobby 2, Seller 3, Brand 4, dan Studio 6. Melewati batas tersebut, pengiriman akan mengembalikan 409.
Apa yang harus saya lakukan saat menerima 429?
Baca header Retry-After, tunggu selama sekian detik, lalu coba lagi dengan exponential backoff. Masukkan pekerjaan ke antrean alih-alih membuangnya.
Endpoint dan referensi
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
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.
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.
- 600 requests/min
- Retry-After: 30s
- async, polling