Batas Laju

Batas laju adalah pembatasan yang diterapkan API kami pada berapa kali pengguna atau klien dapat mengakses layanan kami dalam periode waktu tertentu.

Mengapa Ada Batas

Kami menerapkan batas laju pada API kami untuk membantu menciptakan pengalaman terbaik bagi semua orang. Berikut alasan mengapa hal ini penting:

Untuk menjaga layanan kami tetap aman dan stabil! Anggap batas laju sebagai penjaga pintu 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 lancar.
Untuk memastikan semua orang mendapatkan bagian yang adil. Seperti berbagi mainan di taman bermain, kami ingin memastikan semua pengguna kami memiliki akses yang setara ke API. Dengan membatasi secara wajar berapa banyak permintaan yang dapat dibuat setiap pengguna, kami memastikan tidak ada yang harus menunggu terlalu lama untuk gilirannya.
Untuk menjaga performa tetap cepat dan andal. Dengan mengelola alur 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 menjadi terlalu padat - lalu lintas mengalir lebih baik saat kita mencegah kemacetan!

Cara Kerja Batas

Batas laju diukur dengan 2 cara:

permintaan per detik: Ini adalah jumlah permintaan jaringan yang dapat Anda buat per detik.
tugas antrean: Ini adalah jumlah tugas pembuatan 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 saldo tidak termasuk dalam batas ini.

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

Selain batas laju, prioritas pemrosesan tugas juga akan memengaruhi kecepatan tugas Anda.

Setiap tingkat pengguna memiliki batas laju dan tingkat prioritas tertentu yang dirancang untuk menyesuaikan 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 daripada Pro
Ultra	20	100	Tertinggi
Studio	20	20	Lebih tinggi daripada Pro
Enterprise	100	Default ke 50, 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 hal 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 pembuatan bersamaan yang berjalan. Anda akan menerima respons 429 Too Many Requests dengan pesan NoMoreConcurrentTasks.