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 PenggunaPermintaan per DetikTugas AntreanTingkat Prioritas
Pro2010Default
Premium2030Lebih tinggi dari Pro
Ultra20100Tertinggi
Studio2020Lebih tinggi dari Pro
Enterprise100Default ke 50, dapat disesuaikanTertinggi

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