Had Kadar

Had kadar adalah sekatan yang dikenakan oleh API kami ke atas bilangan kali pengguna atau klien boleh mengakses perkhidmatan kami dalam tempoh masa yang ditetapkan.

---

Mengapa Had Diperlukan

Kami telah menetapkan had kadar pada API kami untuk membantu mewujudkan pengalaman terbaik untuk semua orang. Inilah sebabnya mengapa ia penting:

• Untuk memastikan perkhidmatan kami selamat dan terjamin! Fikirkan had kadar sebagai penjaga pintu yang mesra - mereka memastikan tiada sesiapa boleh membebankan API kami dengan terlalu banyak permintaan sekaligus. Ini membantu melindungi perkhidmatan kami daripada potensi penyalahgunaan dan memastikan segalanya berjalan lancar.

• Untuk memastikan semua orang mendapat bahagian yang adil. Sama seperti berkongsi mainan di taman permainan, kami mahu memastikan semua pengguna kami mempunyai akses yang sama rata kepada API. Dengan menghadkan secara lembut berapa banyak permintaan yang boleh dibuat oleh setiap pengguna, kami memastikan tiada sesiapa perlu menunggu terlalu lama untuk giliran mereka.

• Untuk memastikan prestasi kekal pantas dan boleh dipercayai. Dengan menguruskan aliran keseluruhan permintaan, kami dapat mengekalkan masa tindak balas yang pantas dan perkhidmatan yang stabil untuk semua pengguna kami yang hebat. Ia seperti memastikan lebuh raya tidak terlalu sesak - trafik mengalir dengan lebih baik apabila kami mencegah kesesakan!

---

Bagaimana Had Berfungsi

Had kadar diukur dengan 2 cara:

• permintaan sesaat: Ini adalah bilangan permintaan rangkaian yang anda boleh buat setiap saat.
• tugas beratur: Ini adalah bilangan tugas penjanaan serentak yang anda boleh jalankan dalam baris gilir pada bila-bila masa.

Tugas beratur adalah tugas dalam akaun anda yang berstatus PENDING atau IN_PROGRESS. Setiap endpoint yang mencipta tugas (contohnya Teks ke 3D, Imej ke 3D, Berbilang Imej ke 3D, Retekstur, Remesh, Rigging, Animasi, Teks ke Imej, endpoint pencetakan 3D dan Creative Lab) menyemak had ini sebelum menerima tugas baharu. Permintaan yang tidak mencipta tugas, seperti Balance, Penggunaan, dan mendapatkan semula, menyenaraikan atau menstrim tugas, tidak dikira ke arah had ini, walaupun ia tetap dikira ke arah permintaan sesaat.

Had ini dikenakan bagi setiap akaun, jadi ia dikongsi merentasi semua API key dan Playground anda. Tugas yang anda mulakan dalam aplikasi web Meshy juga dikira ke arah tugas beratur anda.

Selain had kadar, keutamaan pemprosesan tugas juga akan mempengaruhi kelajuan tugas anda.

Setiap peringkat pengguna mempunyai had kadar dan tahap keutamaan tertentu yang direka bentuk mengikut keperluan mereka. Berikut adalah had semasa mengikut peringkat:

Jika anda melebihi had ini, anda akan menerima respons 429 Too Many Requests daripada API kami. Terdapat dua jenis situasi yang boleh mencetuskan ini, setiap satu dengan respons yang berbeza:

• Permintaan Melebihi Had: Ini berlaku apabila anda membuat terlalu banyak permintaan sesaat. Anda akan menerima respons 429 Too Many Requests dengan mesej Rate limit exceeded.
• Baris Gilir Melebihi Had: Ini berlaku apabila anda mempunyai terlalu banyak tugas penjanaan serentak sedang berjalan. Anda akan menerima respons 429 Too Many Requests dengan mesej NoMorePendingTasks (atau, apabila kredit anda habis, NoMoreConcurrentTasks). 429 ini tiada Retry-After: tunggu sehingga salah satu tugas anda selesai sebelum mencipta tugas yang lain.

---

Pengepala Had Kadar

Respons API membawa pengepala berikut supaya anda dapat mengatur rentak permintaan anda:

Apabila Retry-After hadir, tunggu bilangan saat tersebut sebelum menghantar permintaan seterusnya.