Batas Laju

Batas laju adalah pembatasan yang diterapkan API kami pada jumlah akses yang dapat dilakukan pengguna atau klien ke 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 alasannya mengapa hal ini penting:

• Untuk menjaga layanan kami tetap aman dan terkendali! Anggap saja batas laju seperti penjaga yang ramah - mereka memastikan tidak ada yang bisa membanjiri API kami dengan terlalu banyak permintaan sekaligus. Hal ini membantu melindungi layanan kami dari potensi penyalahgunaan dan menjaga semuanya berjalan 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 bisa dibuat setiap pengguna secara wajar, kami memastikan tidak ada yang harus menunggu terlalu lama untuk gilirannya.

• Untuk menjaga performa tetap cepat dan andal. Dengan mengelola alur keseluruhan permintaan, kami dapat mempertahankan waktu respons yang cepat dan layanan yang stabil bagi 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 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 konten yang bersamaan yang dapat Anda jalankan dalam antrean pada waktu tertentu.

Tugas antrean adalah tugas pada akun Anda yang berstatus PENDING atau IN_PROGRESS. Setiap endpoint yang membuat tugas (misalnya Teks ke 3D, Gambar ke 3D, Multi-Gambar ke 3D, Retexture, Remesh, Rigging, Animasi, Teks ke Gambar, endpoint pencetakan 3D, dan Creative Lab) memeriksa batas ini sebelum menerima tugas baru. Permintaan yang tidak membuat tugas, seperti Balance, Usage, serta mengambil, mencantumkan, atau streaming tugas, tidak dihitung dalam batas ini, meskipun tetap dihitung dalam permintaan per detik.

Batas ini diterapkan per akun, sehingga dibagikan di antara semua API key dan Playground Anda. Tugas yang Anda mulai di aplikasi web Meshy juga dihitung dalam tugas antrean 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 sesuai kebutuhannya. Berikut adalah batas saat ini berdasarkan tingkat:

Jika Anda melebihi batas ini, Anda akan menerima respons 429 Too Many Requests dari API kami. Ada dua jenis pelanggaran 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 Rate limit exceeded.
• Queue Hit: Ini terjadi ketika Anda memiliki terlalu banyak tugas pembuatan konten yang bersamaan sedang berjalan. Anda akan menerima respons 429 Too Many Requests dengan pesan NoMorePendingTasks (atau, ketika kredit Anda habis, NoMoreConcurrentTasks). 429 ini tidak memiliki Retry-After: tunggu hingga salah satu tugas Anda selesai sebelum membuat tugas baru.

---

Header Batas Laju

Respons API membawa header berikut agar Anda dapat mengatur ritme permintaan Anda:

Ketika Retry-After muncul, tunggu selama jumlah detik tersebut sebelum mengirim permintaan berikutnya.