Rate Limits

Rate limits adalah pembatasan yang diterapkan oleh API kami terhadap jumlah kali pengguna atau klien dapat mengakses layanan kami dalam periode waktu tertentu.

Why Limits

Kami telah menerapkan rate limits pada API kami untuk membantu menciptakan pengalaman terbaik bagi semua orang. Berikut alasannya mengapa hal ini penting:

Untuk menjaga layanan kami tetap aman dan terjaga! Anggap saja rate limits sebagai penjaga yang ramah - mereka memastikan tidak ada yang dapat membebani 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. Sama seperti berbagi mainan di taman bermain, kami ingin memastikan semua pengguna kami memiliki akses yang setara ke API. Dengan membatasi jumlah permintaan yang dapat dibuat setiap pengguna secara wajar, kami memastikan tidak ada yang harus menunggu terlalu lama untuk giliran mereka.
Untuk menjaga performa tetap cepat dan andal. Dengan mengelola alur keseluruhan permintaan, kami dapat mempertahankan waktu respons yang cepat dan layanan yang stabil untuk semua pengguna kami yang luar biasa. Ini seperti memastikan sebuah jalan raya tidak terlalu padat - lalu lintas mengalir lebih baik ketika kami mencegah kemacetan!

How Limits Work

Rate limits diukur dengan 2 cara:

permintaan per detik: Ini adalah jumlah permintaan jaringan yang dapat Anda buat per detik.
tugas antrean: Ini adalah jumlah tugas generasi yang berjalan bersamaan yang dapat Anda jalankan dalam antrean pada waktu tertentu.

tugas antrean mencakup endpoint Teks ke 3D, Gambar ke 3D, Teks ke Tekstur, dan Remesh. endpoint lain seperti Upload dan Balance tidak termasuk dalam batas ini.

Batas ini diterapkan berdasarkan akun. Ini berarti batas ini dibagikan di seluruh API key Anda.

Selain rate limits, prioritas pemrosesan tugas juga akan memengaruhi kecepatan tugas Anda.

Setiap tingkat pengguna memiliki rate limits dan tingkat prioritas tertentu yang dirancang sesuai dengan kebutuhan mereka. Berikut adalah batas 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 100, dapat disesuaikan	Tertinggi

Jika Anda melebihi batas 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 Requests dengan pesan RateLimitExceeded.
Queue Hit: Ini terjadi ketika Anda memiliki terlalu banyak tugas generasi yang berjalan bersamaan. Anda akan menerima respons 429 Too Many Requests dengan pesan NoMoreConcurrentTasks.