Batasan Kecepatan
Batasan kecepatan adalah pembatasan yang diterapkan API kami pada jumlah akses yang dapat dilakukan oleh pengguna atau klien terhadap layanan kami dalam jangka waktu tertentu.
Mengapa Ada Batasan
Kami menerapkan batasan kecepatan pada API kami untuk membantu menciptakan pengalaman terbaik bagi semua orang. Inilah mengapa batasan ini penting:
-
Untuk menjaga layanan kami tetap aman dan terjamin! Anggap saja batasan kecepatan sebagai penjaga yang ramah - mereka memastikan tidak ada yang dapat membanjiri API kami dengan terlalu banyak permintaan sekaligus. Ini membantu melindungi layanan kami dari potensi penyalahgunaan dan menjaga semuanya berjalan dengan lancar.
-
Untuk memastikan semua orang mendapatkan bagian yang adil. Seperti berbagi mainan di taman bermain, kami ingin memastikan semua pengguna kami memiliki akses yang sama ke API. Dengan membatasi secara lembut berapa banyak permintaan yang dapat dilakukan setiap pengguna, kami memastikan tidak ada yang harus menunggu terlalu lama untuk giliran mereka.
-
Untuk menjaga kinerja tetap cepat dan andal. Dengan mengelola aliran permintaan secara keseluruhan, kami dapat mempertahankan waktu respons yang cepat dan layanan yang stabil untuk semua pengguna kami yang luar biasa. Ini seperti memastikan jalan raya tidak terlalu padat - lalu lintas mengalir lebih baik ketika kita mencegah kemacetan!
Cara Kerja Batasan
Batasan kecepatan diukur dalam 2 cara:
- Permintaan per Detik: Ini adalah jumlah permintaan jaringan yang dapat Anda lakukan per detik.
- Tugas Antrean: Ini adalah jumlah tugas generasi bersamaan yang dapat Anda jalankan dalam antrean pada waktu tertentu.
Tugas antrean termasuk Teks ke 3D, Gambar ke 3D, Teks ke Tekstur, dan endpoint Remesh. Endpoint lain seperti Upload dan Balance tidak termasuk dalam batasan ini.
Batasan diterapkan berdasarkan per akun. Ini berarti bahwa batasan dibagi di semua API key Anda.
Selain batasan kecepatan, prioritas pemrosesan tugas juga akan mempengaruhi kecepatan tugas Anda.
Setiap tingkat pengguna memiliki batasan kecepatan dan tingkat prioritas khusus yang dirancang untuk memenuhi kebutuhan mereka. Berikut adalah batasan saat ini berdasarkan tingkat:
| Tingkat Pengguna | Permintaan per Detik | Tugas Antrean | Tingkat Prioritas |
|---|---|---|---|
| Pro | 20 | 10 | Default |
| Premium | 20 | 30 | Lebih tinggi dari Pro |
| Ultra | 20 | 100 | Tertinggi |
| Studio | 20 | 20 | Lebih tinggi dari Pro |
| Enterprise | 100 | Default ke 50, dapat disesuaikan | Tertinggi |
Jika Anda melebihi batasan ini, Anda akan menerima respons 429 Too Many Requests dari API kami. Ada dua jenis hit yang dapat memicu ini, masing-masing dengan respons yang berbeda:
- Request Hit: Ini terjadi ketika Anda membuat terlalu banyak permintaan per detik. Anda akan menerima respons
429 Too Many Requestsdengan pesanRateLimitExceeded. - Queue Hit: Ini terjadi ketika Anda memiliki terlalu banyak tugas generasi bersamaan yang berjalan. Anda akan menerima respons
429 Too Many Requestsdengan pesanNoMoreConcurrentTasks.